Compartilhar via

New-SCVMNetwork

Módulo:
VirtualMachineManager Module

Cria uma rede de máquina virtual.

Sintaxe

Default (Padrão) 

New-SCVMNetwork
    [-Name] <String>
    [[-Description] <String>]
    -LogicalNetwork <LogicalNetwork>
    [-UserRole <UserRole>]
    [-VMMServer <ServerConnection>]
    [-RoutingDomainId <Guid>]
    [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-Owner <String>]
    [-PortACL <PortACL>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

IsolationType 

New-SCVMNetwork
    [-Name] <String>
    [[-Description] <String>]
    -LogicalNetwork <LogicalNetwork>
    -IsolationType <VMNetworkType>
    [-UserRole <UserRole>]
    [-VMMServer <ServerConnection>]
    [-RoutingDomainId <Guid>]
    [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-Owner <String>]
    [-PortACL <PortACL>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

AutoCreate 

New-SCVMNetwork
    [-Name] <String>
    [[-Description] <String>]
    -LogicalNetwork <LogicalNetwork>
    [-UserRole <UserRole>]
    [-VMMServer <ServerConnection>]
    [-RoutingDomainId <Guid>]
    [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-AutoCreateSubnet]
    [-Owner <String>]
    [-NetworkManager <VirtualSwitchExtensionManager>]
    [-PortACL <PortACL>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

External 

New-SCVMNetwork
    [-Name] <String>
    [[-Description] <String>]
    -LogicalNetwork <LogicalNetwork>
    -ExternalName <String>
    [-UserRole <UserRole>]
    [-VMMServer <ServerConnection>]
    [-RoutingDomainId <Guid>]
    [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-Owner <String>]
    [-PortACL <PortACL>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ExternalVMNetwork 

New-SCVMNetwork
    [-Name] <String>
    [[-Description] <String>]
    -LogicalNetwork <LogicalNetwork>
    [-UserRole <UserRole>]
    [-VMMServer <ServerConnection>]
    [-RoutingDomainId <Guid>]
    [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
    [-ExternalVMNetwork]
    [-Owner <String>]
    [-NetworkManager <VirtualSwitchExtensionManager>]
    [-PortACL <PortACL>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

O cmdlet New-SCVMNetwork cria uma rede de máquina virtual. As redes de máquina virtual dão suporte a vários métodos de isolamento: sem isolamento, virtualização de rede, externa e VLAN. O tipo de isolamento usado pela rede VM depende da rede lógica especificada. O VMM (Virtual Machine Manager) usa os pools de endereços IP associados a uma rede de máquina virtual para atribuir endereços de clientes a máquinas virtuais.

O endereço do cliente é visível para a máquina virtual e é usado pelos clientes para se comunicar com a máquina virtual.

Você deve fornecer um objeto de rede lógica ao criar uma rede de máquina virtual. Para obter um objeto de rede lógico, use o cmdlet Get-SCLogicalNetwork .

Exemplos

Exemplo 1: Criar uma rede de máquina virtual

PS C:\> $LogNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> New-SCVMNetwork -Name "VMNetwork01" -LogicalNetwork $LogNet

O primeiro comando obtém o objeto de rede lógica chamado LogicalNetwork01 e armazena o objeto na variável $LogNet.

O segundo comando cria uma rede VM chamada VMNetwork01 com a rede lógica LogicalNetwork01.

Parâmetros

-AutoCreateSubnet

Indica que uma sub-rede é criada automaticamente.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AutoCreate
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CAIPAddressPoolType

Especifica um tipo de pool de endereços. Os valores válidos são: IPV4, IPV6.

Propriedades do parâmetro

Tipo:VMNetworkIPAddressPoolType
Valor padrão:None
Valores aceitos:IPV4, IPV6
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Especifica uma descrição para a rede de máquinas virtuais.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExternalName

Especifica um nome externo para um objeto.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

External
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExternalVMNetwork

Indica que a rede da máquina virtual é externa.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ExternalVMNetwork
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IsolationType

Especifica um tipo de isolamento para uma rede de máquina virtual. Os valores aceitáveis para este parâmetro são:

  • Sem isolamento
  • WindowsRedeVirtualização
  • Externo
  • VLANNetwork

Propriedades do parâmetro

Tipo:VMNetworkType
Valor padrão:None
Valores aceitos:NoIsolation, WindowsNetworkVirtualization, External, VLANNetwork
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

IsolationType
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-JobVariable

Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LogicalNetwork

Especifica uma rede lógica. Uma rede lógica é um agrupamento nomeado de sub-redes IP e VLANs que é usado para organizar e simplificar as atribuições de rede.

Propriedades do parâmetro

Tipo:LogicalNetwork
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome de um objeto do VMM.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NetworkManager

Especifica um gerenciador de extensão de comutador virtual.

Propriedades do parâmetro

Tipo:VirtualSwitchExtensionManager
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AutoCreate
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ExternalVMNetwork
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Propriedades do parâmetro

Tipo:UserRole
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Owner

Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válida.

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PAIPAddressPoolType

Especifica um tipo de pool de endereços. Os valores válidos são: IPV4, IPV6.

Propriedades do parâmetro

Tipo:VMNetworkIPAddressPoolType
Valor padrão:None
Valores aceitos:IPV4, IPV6
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PortACL

Especifica um objeto ACL de porta.

Propriedades do parâmetro

Tipo:PortACL
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RoutingDomainId

Especifica a ID de um domínio de roteamento na forma de um GUID.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UserRole

Especifica um objeto de função de usuário.

Propriedades do parâmetro

Tipo:UserRole
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

Tipo:ServerConnection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.