Compartilhar via

Set-SCVMHostNetworkAdapter

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades relacionadas à rede para um adaptador de rede físico em um host gerenciado pelo VMM.

Sintaxe

Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanMode <VlanMode>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-SubnetVLan <SubnetVLan[]>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-AddOrSetLogicalNetwork <LogicalNetwork>]
   [-RemoveLogicalNetwork <LogicalNetwork>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanEnabled <Boolean>]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVMHostNetworkAdapter altera as propriedades relacionadas à rede para um adaptador de rede físico em um host gerenciado pelo VMM (Virtual Machine Manager).

As propriedades que você pode alterar com este cmdlet incluem:

  • Configurações de VLAN: você pode usar os parâmetros VLAN para criar ou modificar uma única VLAN ou várias VLANs. Para obter uma ilustração de como especificar as configurações de VLAN, consulte os exemplos.

Para obter mais informações sobre VLANs e exemplos adicionais que ilustram as configurações de VLAN, digite Get-Help Add-SCVMHostNetworkAdapter -Detailed.

Exemplos

Exemplo 1: criar uma nova rede virtual em um adaptador de rede de host e especificar uma ID de VLAN para a rede virtual

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost |  where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35

O primeiro comando obtém o objeto host chamado VMHost02 e armazena o objeto na variável $VMHost.

O segundo comando obtém o objeto do adaptador de rede host com um nome que começa com "Intel(R) PRO/1000 no VMHost02 e armazena o objeto na variável $HostAdapter.

O terceiro comando cria uma rede virtual chamada VirtualNetwork01 no VMHost02 associada ao adaptador de host armazenado em $HostAdapter.

O último comando habilita uma VLAN, define o modo como Access (que roteia o tráfego internamente em uma única VLAN) e atribui ao adaptador de rede um VLANID de 35.

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 indisponível ao servidor VMM impedirá o VMM de gerenciar o host.

Exemplo 2: Adicionar marcas VLan a um adaptador de rede de host configurado no modo tronco

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags

O primeiro comando obtém o objeto host chamado VMHost03 e armazena o objeto na variável $VMHost.

O segundo comando obtém o objeto do adaptador de rede host especificando o nome do adaptador e armazena o objeto na variável $VMHostNIC.

O terceiro comando usa a propriedade VlanTags do objeto do adaptador de rede host ($VMHostNIC.VlanTags) e concatena uma nova matriz de marcas. A matriz atualizada retém as VlanTags existentes e adiciona as marcas listadas à matriz. O resultado da concatenação é armazenado em $NewVlanTags.

O último comando passa a nova lista de marcas VLAN para o parâmetro VLANTrunkID de Set-VMHostNetworkAdapter. O parâmetro VLANMode deve especificar o valor "Trunk" sempre que o parâmetro VLANTrunkID for usado para modificar a lista de identificadores numéricos do tronco VLAN.

Parâmetros

-AddOrSetLogicalNetwork

Especifica uma rede lógica que será adicionada ou atualizada.

Tipo:LogicalNetwork
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AvailableForPlacement

Indica se o processo de posicionamento do VMM considera esse host ou esse volume em um host qualificado como um possível local no qual implantar máquinas virtuais. Se esse parâmetro estiver definido como $False, você poderá optar por implantar máquinas virtuais nesse host ou volume de qualquer maneira. O valor padrão é $True. Esse parâmetro não se aplica aos hosts ESX do VMware.

Quando esse parâmetro é usado com adaptadores de rede, se definido como $False, o posicionamento não considerará as redes lógicas configuradas neste adaptador de rede para determinar se o host é adequado para conectar uma máquina virtual.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Declara uma descrição para o objeto especificado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableNetworkVirtualization

Especifica se a virtualização de rede está habilitada. O valor padrão é $False.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

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

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveLogicalNetwork

Especifica uma rede lógica que será removida.

Tipo:LogicalNetwork
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveUnassignedVLan

Especifica que os VLANs especificados serão removidos do tronco VLAN do adaptador se não estiverem associados a uma rede lógica.

Tipo:UInt16[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveUplinkPortProfileSet

Remove o conjunto de perfis de porta de uplink do adaptador de rede do host.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubnetVLan

Especifica uma ou mais sub-redes IP e conjuntos de VLAN.

Para obter informações sobre como criar uma SubnetVLan, digite Get-Help New-SCSubNetVLan.

Tipo:SubnetVLan[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UplinkPortProfileSet

Especifica um objeto de conjunto de perfil de porta de uplink.

Para obter um objeto de conjunto de perfil de porta de uplink, use o cmdlet Get-SCUplinkPortProfileSet.

Tipo:UplinkPortProfileSet
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UsedForManagement

Indica se o objeto é usado para gerenciar hosts.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VLanEnabled

Habilita 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
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 associado externamente quando o modo VLan for Access.

Configure uma VLanID em um adaptador de rede virtual de uma máquina virtual:

  • Associado a um adaptador de rede física no host ou
  • Associado a uma rede virtual interna no host.

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

Tipo:UInt16
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VLanMode

Especifica se uma LAN virtual (VLAN) em um host de máquina virtual dá suporte ao tráfego em uma única VLAN (modo de acesso) ou em vários VLANs (modo tronco). Os valores válidos são: Access, Trunk.

Tipo:VlanMode
Valores aceitos:Access, Trunk, Invalid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VLanTrunkID

Atribui uma lista de identificadores numéricos no intervalo de 1 a 4094 a um adaptador de rede físico em um host Hyper-V.

Formato de exemplo: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Tipo:UInt16[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMHostNetworkAdapter

Especifica um objeto de adaptador de rede físico em um host ao qual as máquinas virtuais implantadas nesse host podem se conectar.

Formato de exemplo: -VMHostNetworkAdapter $VMHostNIC

Tipo:HostNetworkAdapter
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

VMHostNetworkAdapter

Esse cmdlet retorna um objeto VMHostNetworkAdapter .