Set-SCVirtualNetworkAdapter

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de um adaptador de rede virtual associado a uma máquina virtual, um modelo de máquina virtual ou um perfil de hardware usado para criar máquinas virtuais no VMM.

Syntax

Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   -SlotID <Int32>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   -JobGroup <Guid>
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   [-JobGroup <Guid>]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-IPv4Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv6Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv4AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-IPv6AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-VMMServer <ServerConnection>]
   [[-VirtualNetworkAdapter] <VirtualNetworkAdapter>]
   -VirtualNetwork <String>
   [-Checkpoint]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVirtualNetworkAdapter altera uma ou mais propriedades de um adaptador de rede virtual associado a uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado para criar máquinas virtuais em um ambiente do VMM (Virtual Machine Manager).

As operações que você pode executar incluem o seguinte:

  • Conecte um adaptador de rede virtual a uma rede virtual.

  • Desconecte um adaptador de rede virtual de uma rede virtual.

  • Especifique um local de rede e uma marca de rede em um adaptador de rede virtual.

  • Especifique um endereço MAC no adaptador de rede virtual.

  • Habilite o uso de uma VLAN (rede de área local virtual) e especifique uma ID de VLAN (identificador numérico) para essa VLAN no adaptador de rede virtual.

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: conectar um adaptador de rede virtual a uma rede virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VirtualNetwork "ExternalVirtualNetwork01"

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

O segundo comando obtém todos os objetos do adaptador de rede virtual na VM01, seleciona o objeto do adaptador com o endereço físico (MAC) de 00:16:D3:CC:00:1B e armazena o objeto na variável $Adapter.

O último comando conecta o adaptador de rede virtual armazenado em $Adapter à rede virtual chamada ExternalVirtualNetwork01 no host que contém VM01.

Exemplo 2: Especificar um endereço MAC estático para um adaptador de rede virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.ID -eq "5c0ee80a-731f-41c8-92f0-85a1619f9a1b" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -PhysicalAddressType "Static" -PhysicalAddress "00:16:D3:CC:00:1C"

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

O segundo comando obtém todos os objetos do adaptador de rede virtual na VM02, seleciona o adaptador de rede virtual com a ID especificada e armazena o objeto na variável $Adapter. Este exemplo pressupõe que esse adaptador tenha atualmente um endereço MAC dinâmico.

O último comando especifica que o adaptador de rede virtual armazenado em $Adapter usar o endereço MAC estático 00:16:D3:CC:00:1C.

Exemplo 3: Especificar um endereço MAC estático e atribuí-lo a um adaptador de rede virtual existente

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter (Get-VirtualNetworkAdapter -VM $VM | where { $_.ID -eq "95e9cfda-861c-44a3-b2ba-2f796dfe691c"}) -MACAddressType "Static" -MACAddress "00-00-00-00-00-00"

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

O segundo comando obtém o objeto do adaptador de rede virtual na VM03 por ID, especifica que o adaptador usa um tipo de endereço MAC estático e atribui-lhe um endereço MAC.

Exemplo 4: desconectar o adaptador de rede virtual especificado da rede virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapters[1] -NoConnection

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

O segundo comando obtém todos os objetos do adaptador de rede virtual na VM04 e armazena os objetos do adaptador em $Adapters. Este exemplo pressupõe que a VM04 tenha pelo menos dois adaptadores de rede virtual.

O último comando usa o parâmetro NoConnection para desconectar o segundo adaptador de rede virtual (Adaptadores[1]) de qualquer rede virtual à qual ele está conectado.

Exemplo 5: Especificar um grupo de portas VMware para uma máquina virtual existente

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapter = $VM.VirtualNetworkAdapters[0]
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VMwarePortGroup "VM Network"

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

O segundo comando armazena o primeiro adaptador de rede virtual [0] na VM05 na variável $Adapter.

O último comando define o adaptador de rede virtual para o adaptador armazenado em $Adapter à Rede VM, que é o nome do grupo de portas do VMware ao qual você deseja que esse adaptador se conecte.

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

-Checkpoint

Indica usar a permissão Can Checkpoint.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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 a VMQ (fila de máquinas virtuais) 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

-IPv4Addresses

Especifica uma lista de endereços IPv4.

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv4Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressPools

Especifica uma lista de pools de endereços IPv4.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv4AddressPool
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

-IPv6Addresses

Especifica uma lista de endereços IPv6.

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv6Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressPools

Especifica uma lista de pools de endereços IPv6.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv6AddressPool
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 ser 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

-MACAddress

Especifica o endereço MAC ou um conjunto de endereços MAC para um adaptador de rede físico 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

-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ísico ou para um adaptador de rede virtual ou altera o local de rede padrão do adaptador de rede físico 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 aos quais 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

-NoLogicalNetwork

Indica que nenhuma rede lógica está associada a esse adaptador de rede virtual.

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

-NoPortClassification

Indica que uma classificação de porta não é fornecida.

Type:SwitchParameter
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ísico.

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 da opção à qual o adaptador de rede virtual se conecta.

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

-RemovePortACL

Indica que essa operação remove a ACL (lista de controle de acesso à porta).

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

-RequiredBandwidth

Especifica a largura de banda de rede exigida por um adaptador de rede.

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

-SlotID

Especifica uma ID numérica usada para identificar um dispositivo.

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

-VirtualNetwork

Especifica um objeto de rede virtual.

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

-VirtualNetworkAdapter

Especifica um objeto de adaptador de rede virtual para uma máquina virtual.

Os tipos de hosts dão suporte ao seguinte número de adaptadores de rede virtual:

  • Hyper-V. Até quatro adaptadores emulados por máquina virtual. Não há nenhum driver disponível para um adaptador de rede emulado em um sistema operacional convidado do Windows Server 2003 x64.

  • Hyper-V. Até oito adaptadores sintéticos por máquina virtual.

  • VMware ESX. Até quatro adaptadores emulados por máquina virtual.

  • Citrix XenServer. Até sete adaptadores emulados por máquina virtual.

Type:VirtualNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
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.

  • Exemplo: -VLANEnabled -VLANID 35
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 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 -VLANID 35

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

-VMNetwork

Especifica um objeto de rede de VM.

Para obter um objeto de rede de VM, use o cmdlet Get-SCVMNetwork .

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

-VMNetworkServiceSetting

Especifica uma configuração de serviço de rede de VM.

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

-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 adaptador de rede virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualNetworkAdapter .