Compartilhar via

Add-SCVMHostNetworkAdapter

  • Referência
Módulo:
VirtualMachineManager

Adiciona um adaptador de rede física em um host gerenciado pelo VMM a uma rede virtual.

Sintaxe

Add-SCVMHostNetworkAdapter
   -VirtualNetwork <VirtualNetwork>
   [-VLanEnabled]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Add-SCVMHostNetworkAdapter adiciona um adaptador de rede físico (também chamado de placa de adaptador de rede ou NIC) em um host gerenciado pelo VMM (Virtual Machine Manager) a uma rede virtual. Cada máquina virtual nesse host também pode se conectar por meio de um adaptador de rede virtual a essa rede virtual.

Uma rede virtual configurada em um host pode se conectar a vários adaptadores de rede virtual em máquinas virtuais implantadas nesse host.

O VMM para System Center 2019 e posterior inclui suporte à rede virtual para configurar uma ou mais VLANs (Redes de Área Local Virtual) em um host. Você pode usar o cmdlet Add-SCVMHostNetworkAdapter ou o cmdlet Set-SCVMHostNetworkAdapter para configurar uma única VLAN ou vários VLANs em um host. Para definir as configurações de VLAN correspondentes em uma máquina virtual, use o cmdlet New-SCVirtualNetworkAdapter ou o cmdlet Set-SCVirtualNetworkAdapter.

Para obter uma ilustração de cada tipo de VLAN, consulte os exemplos para este cmdlet.

Exemplos

Exemplo 1: Adicionar um adaptador de rede de host físico a uma rede virtual

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter

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

O segundo comando obtém o objeto de rede virtual chamado ExternalVirtualNetwork01 no VMHost01 e armazena o objeto na variável $VirtualNetwork.

O terceiro comando obtém o objeto do adaptador de rede físico chamado HostAdapter01 no VMHost01 e armazena o objeto na variável $VMHostNetworkAdapter.

O último comando adiciona HostAdapter01 a ExternalVirtualNetwork01.

Observação: você pode adicionar apenas um adaptador de host físico por rede virtual. Portanto, o último comando falhará se um adaptador já estiver associado à rede virtual especificada. Para adicionar um novo adaptador à rede virtual, primeiro você deve remover o adaptador de host existente.

Exemplo 2: adicionar um adaptador de rede de host físico a uma VLAN que usa o modo "Tronco"

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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 de rede virtual chamado ExternalNetwork02 no VMHost02 e armazena o objeto na variável $VirtualNetwork.

O terceiro comando obtém o objeto do adaptador de rede chamado HostAdapter02 no VMHost02 e armazena o objeto do adaptador na variável $VMHostNetworkAdapter.

O último comando adiciona HostAdapter02 à rede virtual ExternalNetwork02 e permite o acesso de ExternalNetwork02 a um dispositivo de rede externo usando VLANs 1, 2, 100, 200 e 1124 marcados por 802,1Q.

Observação: você pode adicionar apenas um adaptador de host por rede virtual, portanto, o último comando falhará se um adaptador já estiver associado à rede virtual especificada.

Exemplo 3: adicionar um adaptador de rede de host físico a uma VLAN que usa o modo "Access"

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22

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 de rede virtual chamado ExternalNetwork03 no VMHost03 e armazena o objeto na variável $VirtualNetwork.

O terceiro comando obtém o objeto do adaptador de rede chamado HostAdapter03 no VMHost03 e armazena o objeto do adaptador na variável$VMHostNetworkAdapter.

O último comando adiciona HostAdapter03 à rede virtual ExternalNetwork03 e restringe o acesso a ExternalNetwork03 ao VLANID 22.

Observação: você pode adicionar apenas um adaptador de host por rede virtual, portanto, o último comando falhará se um adaptador já estiver associado à rede virtual especificada.

Cuidado: este exemplo pressupõe que seu host já esteja conectado a uma VLAN ou, caso contrário, verifique se o host tem 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. Você pode executar as etapas neste exemplo em um host que tenha apenas um adaptador de rede se primeiro instalar o Adaptador de Loopback da Microsoft em seu servidor.

Parâmetros

-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

-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

-VirtualNetwork

Especifica um objeto de rede virtual.

Tipo:VirtualNetwork
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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: formato de exemplo -VLANEnabled -VLANMode "Access" -VLANID 35 para vários VLANs: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Tipo:SwitchParameter
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 é o 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 .