Add-SCVMHostNetworkAdapter
Adiciona um adaptador de rede física em um host gerenciado pelo VMM a uma rede virtual.
Syntax
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 cartão de interface 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 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 $VMHostNetworkAdapterO 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 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,1124O 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 na 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 22O 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 na 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, se não, verifique se o host tem dois adaptadores de rede. Se o host tiver um único adaptador de rede, atribuir o adaptador a uma VLAN que não esteja disponível para o servidor do VMM impedirá que o VMM gerencie 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 executado.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-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 |
-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 |
-VirtualNetwork
Especifica um objeto de rede virtual.
| Type: | VirtualNetwork |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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
| Type: | SwitchParameter |
| 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 host Hyper-V, VMware ESX ou Citrix XenServer:
-- Em um adaptador de rede física externamente associado quando o modo VLan for Access.
Configurar 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
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | VlanMode |
| Accepted values: | Access, Trunk, Invalid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
| Type: | UInt16[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostNetworkAdapter
Especifica um objeto de adaptador de rede física em um host ao qual as máquinas virtuais implantadas nesse host podem se conectar.
Formato de exemplo: -VMHostNetworkAdapter $VMHostNIC
| Type: | HostNetworkAdapter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Saídas
VMHostNetworkAdapter
Esse cmdlet retorna um objeto VMHostNetworkAdapter .