Add-SCVMHostNetworkAdapter
Adiciona um adaptador de rede físico em um host gerenciado pelo VMM a uma rede virtual.
Sintaxe
Default (Predefinição)
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 interface de rede ou NIC) em um host gerenciado pelo Virtual Machine Manager (VMM) 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 de rede virtual para configurar uma ou mais VLANs (Virtual Local Area Networks) em um host. Você pode usar o cmdlet Add-SCVMHostNetworkAdapter ou o cmdlet Set-SCVMHostNetworkAdapter para configurar uma única VLAN ou várias 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 deste cmdlet.
Exemplos
Exemplo 1: Adicionar um adaptador de rede 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 de adaptador de rede físico chamado HostAdapter01 no VMHost01 e armazena o objeto na variável $VMHostNetworkAdapter.
O último comando adiciona HostAdapter01 a ExternalVirtualNetwork01.
Nota: 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, você deve primeiro 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 marcadas 802.1Q 1, 2, 100, 200 e 1124.
Nota: Você pode adicionar apenas um adaptador 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 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 a VLANID 22.
Nota: Você pode adicionar apenas um adaptador 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, certifique-se de que seu host tenha dois adaptadores de rede. Se o host tiver um único adaptador de rede, atribuir o adaptador a uma VLAN que não está disponível para o servidor 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 instalar primeiro o Microsoft Loopback Adapter no servidor.
Parâmetros
-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 de grupo de trabalhos.
Propriedades dos parâmetros
| Tipo: | Guid |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
Propriedades dos parâmetros
| Tipo: | Guid |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-VirtualNetwork
Especifica um objeto de rede virtual.
Propriedades dos parâmetros
| Tipo: | VirtualNetwork |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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árias VLANs: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-VLanID
Atribui um identificador numérico no intervalo 1-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 um VLanID em um host Hyper-V, VMware ESX ou Citrix XenServer:
-- Em um adaptador de rede física vinculado externamente quando o modo VLan é Access.
Configure um VLanID em um adaptador de rede virtual de uma máquina virtual:
- Vinculado a um adaptador de rede físico no host ou
- Vinculado a uma rede virtual interna no host.
Exemplo de formato: -VLanEnabled``-VLanMode "Access" -VLANID 35
Propriedades dos parâmetros
| Tipo: | UInt16 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-VLanMode
Especifica se uma LAN virtual (VLAN) em um host de máquina virtual suporta tráfego em uma única VLAN (modo de acesso) ou em várias VLANs (modo de tronco). Os valores válidos são: Access, Trunk.
Propriedades dos parâmetros
| Tipo: | VlanMode |
| Default value: | None |
| Valores aceites: | Access, Trunk, Invalid |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-VLanTrunkID
Atribui uma lista de identificadores numéricos no intervalo 1-4094 a um adaptador de rede físico em um host Hyper-V.
Exemplo de formato: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Propriedades dos parâmetros
| Tipo: | UInt16[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Exemplo de formato: -VMHostNetworkAdapter $VMHostNIC
Propriedades dos parâmetros
| Tipo: | HostNetworkAdapter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Saídas
VMHostNetworkAdapter
Este cmdlet retorna um objeto VMHostNetworkAdapter .