Partilhar via

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 em 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 num ambiente virtual de Gestor de Máquinas (VMM).

As operações que pode realizar incluem:

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

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

  • Especifique a localização da rede e a marca de rede num adaptador de rede virtual.

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

  • Ativar a utilização de uma rede de área local virtual (VLAN) e especificar um ID VLAN (identificador numérico) para o VLAN no adaptador de rede virtual.

Nota

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

Exemplos

Exemplo 1: Ligar 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 recebe o objeto da máquina virtual chamado VM01 e armazena o objeto na variável $VM.

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

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

Exemplo 2: Especifique 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 da máquina virtual chamado VM02 e armazena o objeto na variável $VM.

O segundo comando obtém todos os objetos adaptadores de rede virtuais em VM02, seleciona o adaptador de rede virtual com o ID especificado e, em seguida, armazena o objeto na variável $Adapter. Este exemplo pressupõe que este adaptador tem atualmente um endereço MAC dinâmico.

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

Exemplo 3: Especifique um endereço MAC estático e atribua-o 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 recebe o objeto da máquina virtual chamado VM03 e armazena o objeto na variável $VM.

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

Exemplo 4: Desligar 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 recebe o objeto da máquina virtual chamado VM04 e armazena o objeto na variável $VM.

O segundo comando obtém todos os objetos adaptador de rede virtuais em VM04 e armazena os objetos adaptador em $Adapters. Este exemplo pressupõe que o VM04 tem pelo menos dois adaptadores de rede virtuais.

O último comando utiliza o parâmetro NoConnection para desligar o segundo adaptador de rede virtual (Adaptadores[1]) de qualquer rede virtual a que esteja ligado.

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 recebe o objeto da máquina virtual chamado VM05 e armazena o objeto na variável $VM.

O segundo comando armazena o primeiro adaptador de rede virtual [0] em 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 porta VMware a que pretende que este adaptador se conecte.

Parâmetros

-AdapterFlags

{{Preenchimento AdaptaerFlags Descrição}}

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 LANs virtuais permitidas num adaptador de rede de máquinas virtuais.

Nota

Este parâmetro é aplicável para VMM 2019 UR3.

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

-Checkpoint

Indica a utilização da permissão de Controlo de Lata.

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 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 da rede IP por um hóspede estão ativadas.

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

-EnableMACAddressSpoofing

Permite, quando definido para $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

Ativa, quando definido para $True, otimização da rede de máquinas virtuais.

Esta funcionalidade melhora o desempenho da rede para máquinas virtuais com adaptadores de rede que suportam a fila de máquinas virtuais (VMQ) ou O Offload da Chaminé TCP. O VMQ permite criar uma fila de rede única para cada adaptador de rede virtual. O Descarregamento da 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 piscinas 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 este parâmetro são:

  • Dinâmica
  • 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 piscinas 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 este parâmetro são:

  • Dinâmica
  • 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 funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.

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

-JobVariable

Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este 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 que é usado para organizar e simplificar as 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 num 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 para utilizar para um adaptador de rede virtual. Os valores válidos são: Estática, Dinâmica.

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

-NativeVLanId

Especifica o identificador LAN virtual nativo para um adaptador de rede de máquinas virtuais.

Nota

Este parâmetro é aplicável para VMM 2019 UR3.

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

-NetworkLocation

Especifica a localização da rede para um adaptador de rede física ou para um adaptador de rede virtual, ou altera a localização de rede padrão do adaptador de rede física do hospedeiro.

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 para associar a um adaptador de rede virtual configurado para ligar a uma rede interna ou externa específica no anfitrião.

O parâmetro NetworkTag identifica todas as máquinas virtuais com o mesmo NetworkTag que os membros da mesma rede. O VMM utiliza um NeworkTag (se existe) quando avalia os anfitriões como possíveis candidatos para implantar uma máquina virtual. Se o hospedeiro não incluir máquinas virtuais na rede com o mesmo NetworkTag que a máquina virtual a ser colocada, o anfitrião recebe zero estrelas no processo de colocação.

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

-NoConnection

Desliga 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 este 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 não é fornecida uma classificação portuária.

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

-OnBehalfOfUser

Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

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

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

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.

Nota

Este parâmetro é aplicável para 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 portuária do interruptor ao 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 o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RemovePortACL

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

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 funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-SlotID

Especifica um ID numérico usado 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 adaptador de rede virtual para uma máquina virtual.

Os tipos de anfitriões suportam o seguinte número de adaptadores de rede virtuais:

  • Hiper-V. Até quatro adaptadores emulados por máquina virtual. Não existe nenhum controlador disponível para um adaptador de rede emulsionado num sistema operativo de hóspedes Windows Server 2003 x64.

  • Hiper-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 permite a utilização de um LAN virtual (VLAN) por máquinas virtuais num hospedeiro 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 1-4094 a um adaptador de rede virtual numa máquina virtual ou a um adaptador de rede física num hospedeiro de máquina virtual.

Configure um VLanID num adaptador de rede virtual de uma máquina virtual ligada a um adaptador de rede física no hospedeiro, ou ligado a uma rede virtual interna no hospedeiro.

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 VMM.

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

-VMNetwork

Especifica um objeto de rede VM.

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

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

-VMNetworkServiceSetting

Especifica uma definição de serviço de rede 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 , utilize 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 VMware.

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

Saídas

VirtualNetworkAdapter

Este cmdlet devolve um objeto VirtualNetworkAdapter .

Notas

  • Requer um objeto adaptador de rede virtual VMM, que pode ser recuperado utilizando o cmdlet Get-SCVirtualNetworkAdapter .