New-SCVMNetwork

Módulo:

VirtualMachineManager

Cria uma rede de máquina virtual.

Syntax

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 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 cliente 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ógica, 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 de VM chamada VMNetwork01 com a rede lógica LogicalNetwork01.

Parâmetros

-AutoCreateSubnet

Indica que uma sub-rede é criada automaticamente.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CAIPAddressPoolType

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

Type:	VMNetworkIPAddressPoolType
Accepted values:	IPV4, IPV6
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExternalName

Especifica um nome externo para um objeto.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ExternalVMNetwork

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-IsolationType

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

• NoIsolation
• WindowsNetworkVirtualization
• Externo
• VLANNetwork

Type:	VMNetworkType
Accepted values:	NoIsolation, WindowsNetworkVirtualization, External, VLANNetwork
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogicalNetwork

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

Type:	LogicalNetwork
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Especifica o nome de um objeto VMM.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NetworkManager

Especifica um gerenciador de extensões de comutador virtual.

Type:	VirtualSwitchExtensionManager
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-OnBehalfOfUser

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Owner

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PAIPAddressPoolType

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

Type:	VMNetworkIPAddressPoolType
Accepted values:	IPV4, IPV6
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PortACL

Especifica um objeto ACL de porta.

Type:	PortACL
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

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

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RoutingDomainId

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

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserRole

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

Type:	UserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMMServer

Especifica um objeto de servidor do VMM.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Links Relacionados

• Get-SCLogicalNetwork
• Get-SCVMNetwork
• Remove-SCVMNetwork
• Set-SCVMNetwork