New-SCVirtualNetworkAdapter

  • Referência
Módulo:
VirtualMachineManager

Cria um adaptador de rede virtual em uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado no VMM.

Syntax

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VM <VM>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMHost <Host>]
   [-LogicalSwitch <LogicalSwitch>]
   -JobGroup <Guid>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VMTemplate <Template>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -HardwareProfile <HardwareProfile>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   -VMHost <Host>
   -LogicalSwitch <LogicalSwitch>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet New-SCVirtualNetworkAdapter cria um adaptador de rede virtual em uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado para criar máquinas virtuais gerenciadas pelo VMM (Virtual Machine Manager).

Local de rede

Você pode usar o cmdlet New-SCVirtualNetworkAdapter para especificar um local de rede e conectar o adaptador de rede virtual a uma rede virtual configurada no host quando você cria o adaptador ou pode configurar essas e outras configurações posteriormente usando o cmdlet Set-SCVirtualNetworkAdapter .

Endereço MAC estático ou dinâmico

Você pode especificar se o adaptador de rede virtual usa um endereço MAC estático ou dinâmico e pode especificar um endereço MAC estático.

Adaptadores de Rede Virtual sintéticos ou emulados

Você pode usar o cmdlet New-SCVirtualNetworkAdapter para criar um adaptador cujo tipo é emulado (o padrão) ou sintético.

Para máquinas virtuais em qualquer tipo de host (Hyper-V, VMware ou XenServer), você pode configurar um adaptador de rede virtual na máquina virtual que emula um adaptador de rede físico específico.

Para máquinas virtuais em hosts Hyper-V, se o sistema operacional convidado instalado em uma máquina virtual for um sistema operacional com reconhecimento de virtualização (por exemplo, Windows Server 2008 ou Windows Server 2016 e algumas versões do Linux), o VMM permitirá que você configure um adaptador de rede virtual sintética de alto desempenho na máquina virtual para se comunicar com o hardware físico no host. Você deve especificar explicitamente que um adaptador de rede virtual é sintético usando o parâmetro Synthetic .

Rede de Área Local Virtual

O VMM inclui suporte para configurar uma ou mais VLANs (redes de área virtual) em um host para uso por máquinas virtuais implantadas nesse host. Você pode usar o cmdlet New-SCVirtualNetworkAdapter (ou o cmdlet Set-SCVirtualNetworkAdapter ) com os parâmetros VLAN para anexar o adaptador de rede virtual em uma máquina virtual a uma VLAN. Para definir as configurações de VLAN correspondentes no adaptador de rede do host, use o cmdlet Add-SCVMHostNetworkAdapter ou o cmdlet Set-SCVMHostNetworkAdapter .

Para obter uma ilustração de como configurar VLANs, consulte os exemplos desse cmdlet e veja os exemplos de New-SCVMHostNetworkAdapterConfig e Set-SCVMHostNetworkAdapter.

Observação

  • Um novo parâmetro [-PhysicalNetworkAdapterName] está incluído no VMM 2019 UR2. Para obter mais informações, confira Parâmetros.
  • Novos parâmetros [-AllowedVLanList] e [-NativeVLanId] estão incluídos no VMM 2019 UR3. Para obter mais informações, confira Parâmetros.

Exemplos

Exemplo 1: criar um adaptador de rede virtual em uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando cria um adaptador de rede virtual no VM01.

Exemplo 2: criar um adaptador de rede virtual em um modelo de máquina virtual

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualNetworkAdapter -VMTemplate $VMTemplate

O primeiro comando obtém o objeto de modelo de máquina virtual chamado VMTemplate01 e armazena o objeto na variável $VMTemplate.

O segundo comando cria um adaptador de rede virtual em VMTemplate01.

Exemplo 3: criar um adaptador de rede virtual emulado e um adaptador de rede virtual sintética em um perfil de hardware

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile -Synthetic

O primeiro comando obtém o objeto de perfil de hardware chamado NewHWProfile01 da biblioteca do VMM e armazena o objeto na variável $HWProfile.

O segundo comando cria um adaptador de rede virtual (um adaptador "nativo" ou emulado) no NewHWProfile01.

O último comando cria um adaptador de rede virtual sintética no NewHWProfile01.

Exemplo 4: criar um adaptador de rede virtual em uma máquina virtual e atribuí-lo a um endereço MAC exclusivo

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $VNIC = New-SCVirtualNetworkAdapter -VM $VM
PS C:\> $MACPool = Get-SCMACAddressPool -Name "MAC Address Pool 01"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACPool -VirtualNetworkAdapter $VNIC

O primeiro comando obtém o objeto de máquina virtual chamado VM04 e armazena o objeto na variável $VM.

O segundo comando cria um adaptador de rede virtual na máquina virtual armazenada em $VM (VM04) e armazena o objeto na variável $VNIC.

O terceiro comando obtém o objeto do pool de endereços MAC chamado Mac Address Pool 01 e armazena o objeto na variável $MACPool.

O último comando obtém o próximo endereço MAC disponível do pool de endereços armazenado em $MACPool e o atribui ao adaptador de rede virtual armazenado em $VNIC.

Exemplo 5: criar um adaptador de rede virtual com um endereço MAC estático e uma ID de VLAN específica

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $LogicalNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $VirtualNet = Get-SCVirtualNetwork -Name "ExternalVirtualNetwork01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM -LogicalNetwork $LogicalNet -VirtualNetwork $VirtualNet -MACAddress "00-16-D3-CC-00-1A" -MACAddressType "Static" -VLANEnabled $True -VLANId 3

O primeiro comando obtém o objeto de máquina virtual chamado VM05 e armazena o objeto na variável $VM.

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

O terceiro comando obtém o objeto de rede virtual chamado ExternalVirtualNetwork01 e armazena o objeto na variável $VirtualNet.

O último comando cria um novo adaptador de rede virtual para VM05, conecta o adaptador à rede lógica armazenada em $LogicalNet e à rede virtual armazenada em $VirtualNet. O comando fornece um endereço MAC estático para o adaptador de rede virtual, habilita a VLAN e especifica uma ID de VLAN de 3.

Observação: este exemplo pressupõe que seu host já esteja conectado a uma VLAN ou, se não, que seu host tenha dois adaptadores de rede. Se o host tiver um único adaptador de rede, atribuir o adaptador a uma VLAN que não esteja disponível para o servidor do VMM impedirá que o VMM gerencie o host.

Parâmetros

-AdapterFlags

{{Fill AdapterFlags Description}}

Type:VirtualNetworkAdapterFlags
Accepted values:None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowedVLanList

Especifica uma lista de VLANs permitidas em um adaptador de rede da máquina virtual.

Observação

Esse parâmetro é aplicável ao VMM 2019 UR3.

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

-DevicePropertiesAdapterName

Especifica o nome de um adaptador de rede.

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

-DevicePropertiesAdapterNameMode

Especifica o modo de nome do adaptador.

Type:DevicePropertiesAdapterNameMode
Accepted values:Disabled, VMNetwork, Custom
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableGuestIPNetworkVirtualizationUpdates

Indica se as atualizações de virtualização de rede IP por um convidado estão habilitadas.

Type:Boolean
Aliases:GuestIPNetworkVirtualizationUpdatesEnabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableMACAddressSpoofing

Habilita, quando definido como $True, falsificação de endereço MAC.

Type:Boolean
Aliases:MACAddressesSpoofingEnabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableVMNetworkOptimization

Habilita, quando definido como $True, otimização de rede de máquina virtual.

Esse recurso melhora o desempenho da rede para máquinas virtuais com adaptadores de rede que dão suporte à fila de máquinas virtuais (VMQ) ou descarregamento de chaminé TCP. O VMQ permite a criação de uma fila de rede exclusiva para cada adaptador de rede virtual. O Descarregamento de Chaminé TCP permite que o processamento de tráfego de rede seja descarregado da pilha de rede.

Type:Boolean
Aliases:VMNetworkOptimizationEnabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HardwareProfile

Especifica um objeto de perfil de hardware.

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

-InheritsAddressFromPhysicalNetworkAdapter

Indica se o adaptador de rede herda seu endereço de um adaptador de rede físico.

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

-IPv4Address

Especifica um endereço IPv4.

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

-IPv4AddressPool

Especifica um pool de endereços estáticos que contém endereços IPv4.

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

-IPv4AddressType

Especifica um tipo de endereço IPv4. Os valores aceitáveis para esse parâmetro são:

  • Dinâmico
  • Estático
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6Address

Especifica um endereço IPv6.

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

-IPv6AddressPool

Especifica um pool de endereços estáticos que contém endereços IPv6.

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

-IPv6AddressType

Especifica um tipo de endereço IPv6. Os valores aceitáveis para esse parâmetro são:

  • Dinâmico
  • Estático
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho executado.

Type:Guid
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:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalSwitch

Especifica um objeto de comutador lógico.

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

-MACAddress

Especifica o endereço MAC ou um conjunto de endereços MAC para um adaptador de rede física ou virtual em um computador.

  • Formato de exemplo para um único endereço MAC: -MACAddress "00-15-5D-B4-DC-00"
  • Formato de exemplo para um conjunto de endereços MAC: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Type:String
Aliases:EthernetAddress, PhysicalAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MACAddressType

Especifica o tipo de endereço MAC a ser usado para um adaptador de rede virtual. Os valores válidos são: Estático, Dinâmico.

Type:String
Aliases:EthernetAddressType, PhysicalAddressType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de um objeto de rede.

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

-NativeVLanId

Especifica o identificador de LAN virtual nativo para um adaptador de rede da máquina virtual.

Observação

Esse parâmetro é aplicável ao VMM 2019 UR3.

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

-NetworkLocation

Especifica o local de rede para um adaptador de rede física ou para um adaptador de rede virtual ou altera o local de rede padrão do adaptador de rede física de um host.

Formatos de exemplo: -NetworkLocation $NetLoc ($NetLoc pode conter Corp.Contoso.com) -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"

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

-NetworkTag

Especifica uma palavra ou frase a ser associada a um adaptador de rede virtual configurado para se conectar a uma rede interna ou externa específica no host.

O parâmetro NetworkTag identifica todas as máquinas virtuais com a mesma NetworkTag que os membros da mesma rede. O VMM usa uma NeworkTag (se existir) quando avalia os hosts como possíveis candidatos para implantar uma máquina virtual. Se o host não incluir máquinas virtuais na rede com a mesma NetworkTag que a máquina virtual a ser colocada, o host receberá zero estrelas no processo de posicionamento.

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

-NoConnection

Desconecta um adaptador de rede virtual de uma rede virtual.

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

-NoVMNetwork

Indica que uma rede de máquina virtual não é especificada.

Type:SwitchParameter
Aliases:NoLogicalNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-PhysicalNetworkAdapterName

Especifica o nome do adaptador de rede física.

Observação

Esse parâmetro é aplicável ao VMM 2019 UR2.

Type:String
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

-PortClassification

Especifica a classificação de porta do comutador ao qual o adaptador de rede virtual se conecta.

Type:PortClassification
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

-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

-Synthetic

Especifica que um dispositivo, como um adaptador de rede virtual, em uma máquina virtual implantada em um host Hyper-V é um dispositivo sintético de alto desempenho. Requer um sistema operacional convidado com reconhecimento de virtualização na máquina virtual.

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

-VirtualNetwork

Especifica um objeto de rede virtual.

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

-VLanEnabled

Indica se é necessário habilitar uma LAN virtual (VLAN) para uso por máquinas virtuais em um host Hyper-V ou Citrix XenServer.

  • Formato de exemplo para uma única VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
  • Formato de exemplo para vários VLANs: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanID

Atribui um identificador numérico no intervalo de 1 a 4094 a um adaptador de rede virtual em uma máquina virtual ou a um adaptador de rede física em um host de máquina virtual.

Configure uma VLanID em um host Hyper-V, VMware ESX ou Citrix XenServer em um adaptador de rede física externamente associado quando o modo VLan for Access.

Configure uma VLanID em um adaptador de rede virtual de uma máquina virtual associada a um adaptador de rede física no host ou vinculada a uma rede virtual interna no host.

Formato de exemplo: -VLanEnabled -VLanMode "Access" -VLANID 35

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

-VM

Especifica um objeto de máquina virtual.

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

-VMHost

Especifica um objeto host de máquina virtual. O VMM dá suporte a hosts Hyper-V, hosts ESX VMware e hosts Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost .

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

-VMMServer

Especifica um objeto de servidor do VMM.

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

-VMNetwork

Especifica um objeto de rede de máquina virtual.

Para obter um objeto de rede de máquina virtual, use o cmdlet Get-SCVMNetwork .

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

-VMNetworkServiceSetting

Especifica uma configuração de serviço de rede de máquina virtual.

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

-VMSubnet

Especifica um objeto de sub-rede de máquina virtual.

Para obter um objeto VMSubnet , use o cmdlet Get-SCVMSubnet .

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

-VMTemplate

Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.

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

-VMwarePortGroup

Especifica o grupo de portas do VMware.

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

Saídas

VirtualNetworkAdapter

Esse cmdlet retorna um objeto VirtualNetworkAdapter .

Observações

  • Requer um objeto de máquina virtual do VMM, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware, que pode ser recuperado usando os cmdlets Get-SCVirtualMachine, Get-SCVMTemplate e Get-SCHardwareProfile , respectivamente.