Partilhar via

New-SCVMNetwork

  • Referência
Módulo:
VirtualMachineManager

Cria uma rede de máquina virtual.

Sintaxe

New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-RoutingDomainId <Guid>]
   [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-Owner <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-RoutingDomainId <Guid>]
   -IsolationType <VMNetworkType>
   [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-Owner <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-RoutingDomainId <Guid>]
   [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-AutoCreateSubnet]
   [-Owner <String>]
   [-NetworkManager <VirtualSwitchExtensionManager>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-RoutingDomainId <Guid>]
   [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   -ExternalName <String>
   [-Owner <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-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áquinas virtuais suportam vários métodos de isolamento: Sem isolamento, virtualização de rede, externo e VLAN. O tipo de isolamento usado pela rede VM depende da rede lógica especificada. O Virtual Machine Manager (VMM) usa os pools de endereços IP associados a uma rede de máquinas virtuais 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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CAIPAddressPoolType

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

Tipo:VMNetworkIPAddressPoolType
Valores aceites:IPV4, IPV6
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

Especifica uma descrição para a rede de máquina virtual.

Tipo:String
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ExternalName

Especifica um nome externo para um objeto.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ExternalVMNetwork

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IsolationType

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

  • NãoIsolamento
  • WindowsNetworkVirtualization
  • Externa
  • VLANNetwork
Tipo:VMNetworkType
Valores aceites:NoIsolation, WindowsNetworkVirtualization, External, VLANNetwork
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 atribuições de rede.

Tipo:LogicalNetwork
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NetworkManager

Especifica um gerenciador de extensão de comutador virtual.

Tipo:VirtualSwitchExtensionManager
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OnBehalfOfUser

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

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

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Owner

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

  • Exemplo de formato: -Owner "Contoso\PattiFuller"
  • Exemplo de formato: -Owner "PattiFuller@Contoso"
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PAIPAddressPoolType

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

Tipo:VMNetworkIPAddressPoolType
Valores aceites:IPV4, IPV6
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PortACL

Especifica um objeto ACL de porta.

Tipo:PortACL
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RoutingDomainId

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

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserRole

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

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False