Partilhar via

Set-SCVirtualNetworkAdapter

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de um adaptador de rede virtual associado a uma máquina virtual, a um modelo de máquina virtual ou a um perfil de hardware utilizado 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 utilizado para criar máquinas virtuais num ambiente do Virtual Machine Manager (VMM).

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

  • Ligue uma placa de rede virtual a uma rede virtual.

  • Desligue uma placa de rede virtual de uma rede virtual.

  • Especifique uma localização de rede e uma etiqueta de rede numa placa de rede virtual.

  • Especifique um endereço MAC na placa de rede virtual.

  • Ative a utilização de uma rede de área local virtual (VLAN) e especifique um ID de VLAN (identificador numérico) para essa VLAN na placa de rede virtual.

Nota

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

Exemplos

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

O segundo comando obtém todos os objetos de placa 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, em seguida, armazena o objeto na variável $Adapter.

O último comando liga o adaptador de rede virtual armazenado no $Adapter à rede virtual com o nome ExternalVirtualNetwork01 no anfitrião que contém a VM01.

Exemplo 2: Especificar um endereço MAC estático para uma placa 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 com o nome VM02 e armazena o objeto na variável $VM.

O segundo comando obtém todos os objetos de placa de rede virtual na 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 no $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 uma placa 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 da máquina virtual com o nome VM03 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto de placa de rede virtual na 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 a placa de rede virtual especificada 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 da máquina virtual com o nome VM04 e armazena o objeto na variável $VM.

O segundo comando obtém todos os objetos de placa de rede virtual na VM04 e armazena os objetos do adaptador no $Adapters. Este exemplo pressupõe que a VM04 tem, pelo menos, duas placas de rede virtual.

O último comando utiliza o parâmetro NoConnection para desligar a segunda placa de rede virtual (Adaptadores[1]) de qualquer rede virtual à qual esteja ligada.

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 da máquina virtual com o nome 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 no $Adapter para a Rede VM, que é o nome do grupo de portas VMware ao qual pretende que este adaptador se ligue.

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 LANs virtuais permitidas numa placa de rede de máquina virtual.

Nota

Este parâmetro é aplicável ao UR3 do VMM 2019 e posterior.

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

-Checkpoint

Indica para utilizar a permissão Pode Ponto de Verificação.

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

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

-EnableMACAddressSpoofing

Ativa, quando definido como $True, spoofing de endereços MAC.

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

-EnableVMNetworkOptimization

Ativa, quando definido como $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 TCP Chimney Offload. O VMQ permite criar uma fila de rede exclusiva para cada placa de rede virtual. A Descarga 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 conjuntos 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 conjuntos 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 serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador do grupo de tarefas.

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

-JobVariable

Especifica que o progresso da tarefa é controlado e armazenado na variável denominada 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 com nome de sub-redes IP e VLANs que é utilizado 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 uma placa de rede física 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 a utilizar para uma placa 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 lan virtual nativo de um adaptador de rede de máquina virtual.

Nota

Este parâmetro é aplicável ao UR3 do VMM 2019 e posterior.

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

-NetworkLocation

Especifica a localização de rede para uma placa de rede física ou para uma placa de rede virtual ou altera a localização de rede predefinida da placa de rede física de um anfitrião.

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 expressão 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 existir) quando avalia os anfitriões como possíveis candidatos para implementar uma máquina virtual. Se o anfitrião não incluir máquinas virtuais na rede com o mesmo NetworkTag que a máquina virtual a colocar, 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 uma placa 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 esta placa 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 de porta.

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 especificada por este parâmetro.

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

-PhysicalNetworkAdapterName

Especifica o nome da placa de rede física.

Nota

Este parâmetro é aplicável ao UR2 do VMM 2019 e posterior.

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 portas do comutador ao qual o adaptador de rede virtual se liga.

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

-PROTipID

Especifica o ID da sugestão desempenho e Otimização de Recursos (sugestão PRO) que acionou esta ação. Este parâmetro permite-lhe auditar sugestões 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 necessária 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 a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos.

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

-SlotID

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

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

  • Hyper-V. Até quatro adaptadores emulados por máquina virtual. Não existe nenhum controlador disponível para um adaptador de rede emulado num sistema operativo 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 pretende ativar uma LAN virtual (VLAN) para utilização por máquinas virtuais num anfitrião 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 uma placa de rede virtual numa máquina virtual ou a uma placa de rede física num anfitrião de máquina virtual.

Configure um VLanID numa placa de rede virtual de uma máquina virtual vinculada a uma placa de rede física no anfitrião ou vinculada a uma rede virtual interna no anfitrião.

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 de 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 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 , 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 de placa de rede virtual do VMM, que pode ser obtido com o cmdlet Get-SCVirtualNetworkAdapter .