Add-SCVMHostNetworkAdapter
Adiciona uma placa de rede física num anfitrião gerido 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 uma placa de rede física (também denominada placa de interface de rede ou NIC) num anfitrião gerido pelo Virtual Machine Manager (VMM) a uma rede virtual. Cada máquina virtual nesse anfitrião também pode ligar-se através de uma placa de rede virtual a essa rede virtual.
Uma rede virtual configurada num anfitrião pode ligar a vários adaptadores de rede virtual em máquinas virtuais implementadas nesse anfitrião.
O VMM para System Center 2019 e posterior inclui suporte de rede virtual para configurar uma ou mais Redes Locais Virtuais (VLANs) num anfitrião. Pode utilizar o cmdlet Add-SCVMHostNetworkAdapter ou o cmdlet Set-SCVMHostNetworkAdapter para configurar uma única VLAN ou várias VLANs num anfitrião. Para configurar as definições de VLAN correspondentes numa máquina virtual, utilize o cmdlet New-SCVirtualNetworkAdapter ou o cmdlet Set-SCVirtualNetworkAdapter .
Para obter uma ilustração de cada tipo de VLAN, veja os exemplos deste cmdlet.
Exemplos
Exemplo 1: adicionar um adaptador de rede anfitrião 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 anfitrião com o nome VMHost01 e armazena o objeto na variável $VMHost.
O segundo comando obtém o objeto de rede virtual com o nome ExternalVirtualNetwork01 no VMHost01 e armazena o objeto na variável $VirtualNetwork.
O terceiro comando obtém o objeto de placa de rede física denominado HostAdapter01 no VMHost01 e armazena o objeto na variável $VMHostNetworkAdapter.
O último comando adiciona HostAdapter01 a ExternalVirtualNetwork01.
Nota: só pode adicionar um adaptador anfitrião físico por rede virtual. Por conseguinte, o último comando falhará se um adaptador já estiver associado à rede virtual especificada. Para adicionar um novo adaptador à rede virtual, primeiro tem de remover o adaptador anfitrião existente.
Exemplo 2: adicionar um adaptador de rede anfitrião físico a uma VLAN que utiliza o modo "Ramal"
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 anfitrião com o nome VMHost02 e armazena o objeto na variável $VMHost.
O segundo comando obtém o objeto de rede virtual com o nome ExternalNetwork02 no VMHost02 e armazena o objeto na variável $VirtualNetwork.
O terceiro comando obtém o objeto de placa de rede denominado 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 com VLANs 1, 2, 100, 200, 200 e 1124 com etiquetas 802.1Q.
Nota: só pode adicionar um adaptador anfitrião por rede virtual, pelo que o último comando falhará se um adaptador já estiver associado à rede virtual especificada.
Exemplo 3: adicionar um adaptador de rede anfitrião físico a uma VLAN que utiliza 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 anfitrião com o nome VMHost03 e armazena o objeto na variável $VMHost.
O segundo comando obtém o objeto de rede virtual com o nome ExternalNetwork03 no VMHost03 e armazena o objeto na variável $VirtualNetwork.
O terceiro comando obtém o objeto de placa de rede denominado 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: só pode adicionar um adaptador anfitrião por rede virtual, pelo que o último comando falhará se um adaptador já estiver associado à rede virtual especificada.
Atenção: este exemplo pressupõe que o anfitrião já está ligado a uma VLAN ou, caso contrário, certifique-se de que o anfitrião tem duas placas de rede. Se o anfitrião tiver um único adaptador de rede, atribuir o adaptador a uma VLAN que não esteja disponível para o servidor VMM impedirá o VMM de gerir o anfitrião. Pode efetuar os passos neste exemplo num anfitrião que tenha apenas um adaptador de rede se instalar primeiro o Microsoft Loopback Adapter no seu 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 do grupo de tarefas.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-PROTipID
Especifica o ID da sugestão de 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 |
-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 |
-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
Ativa uma LAN virtual (VLAN) para utilização por máquinas virtuais num anfitrião 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
| 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 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 num anfitrião Hyper-V, VMware ESX ou Citrix XenServer:
-- Num adaptador de rede física vinculado externamente quando o modo VLan é o Access.
Configurar um VLanID numa placa de rede virtual de uma máquina virtual:
- Vincular a uma placa de rede física no anfitrião ou
- Vinculado a uma rede virtual interna no anfitrião.
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) num anfitrião de máquina virtual suporta tráfego numa única VLAN (modo de acesso) ou em várias VLANs (modo de ramal). 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 1-4094 a uma placa de rede física num anfitrião 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 placa de rede física num anfitrião ao qual as máquinas virtuais implementadas nesse anfitrião se podem ligar.
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
Este cmdlet devolve um objeto VMHostNetworkAdapter .