Add-SCVMHostNetworkAdapter
Adiciona um adaptador de rede físico num hospedeiro gerido por 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 Add-SCVMHostNetworkAdapter adiciona um adaptador de rede física (também chamado de cartão de interface de rede, ou NIC) num hospedeiro gerido pelo Virtual Machine Manager (VMM) a uma rede virtual. Cada máquina virtual nesse hospedeiro também pode ligar-se através de um adaptador de rede virtual a essa rede virtual.
Uma rede virtual configurada num hospedeiro pode ligar-se a vários adaptadores de rede virtuais em máquinas virtuais implantadas nesse hospedeiro.
O VMM para o System Center 2019 inclui suporte de rede virtual para configurar uma ou mais Redes de Área Local Virtual (VLANs) num hospedeiro. Pode utilizar o cmdlet Add-SCVMHostNetworkAdapter ou o cmdlet Set-SCVMHostNetworkAdapter para configurar um único VLAN ou vários VLANs num hospedeiro. Para configurar as definições 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, consulte os exemplos para este cmdlet.
Exemplos
Exemplo 1: Adicionar um adaptador de rede de anfitriões físicos 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 recebe o objeto anfitrião chamado VMHost01 e armazena o objeto na variável $VMHost.
O segundo comando obtém o objeto de rede virtual chamado ExternalVirtualNetwork01 em VMHost01 e armazena o objeto na variável $VirtualNetwork.
O terceiro comando obtém o objeto adaptador de rede física chamado HostAdapter01 em VMHost01 e armazena o objeto na variável $VMHostNetworkAdapter.
O último comando adiciona HostAdapter01 a ExternalVirtualNetwork01.
Nota: Pode adicionar apenas um adaptador de hospedeiro 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, tem primeiro de remover o adaptador de hospedeiro existente.
Exemplo 2: Adicione um adaptador de rede de anfitriões físicos a um VLAN que utiliza 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 recebe o objeto anfitrião chamado VMHost02 e armazena o objeto na variável $VMHost.
O segundo comando obtém o objeto de rede virtual chamado ExternalNetwork02 em VMHost02 e armazena o objeto na variável $VirtualNetwork.
O terceiro comando obtém o objeto adaptador de rede chamado HostAdapter02 em VMHost02 e armazena o objeto 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 utilizando VLANs 1, 2, 100, 200 e 1124.
Nota: Pode adicionar apenas um adaptador de anfitrião por rede virtual, pelo que o último comando falhará se um adaptador já estiver associado à rede virtual especificada.
Exemplo 3: Adicione um adaptador de rede de anfitriões físicos a um VLAN que utiliza o modo "Acesso"
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 recebe o objeto anfitrião chamado VMHost03 e armazena o objeto na variável $VMHost.
O segundo comando obtém o objeto de rede virtual chamado ExternalNetwork03 em VMHost03 e armazena o objeto na variável $VirtualNetwork.
O terceiro comando obtém o objeto adaptador de rede chamado HostAdapter03 em VMHost03 e armazena o objeto adaptador na variável$VMHostNetworkAdapter.
O último comando adiciona hostAdapter03 à rede virtual ExternalNetwork03 e restringe o acesso à ExternalNetwork03 a VLANID 22.
Nota: Pode adicionar apenas um adaptador de 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 seu anfitrião já está ligado a um VLAN ou, caso contrário, certifique-se de que o seu anfitrião tem dois adaptadores de rede. Se o seu anfitrião tiver um único adaptador de rede, atribuir o adaptador a um VLAN que não esteja disponível para o servidor VMM impedirá a VMM de gerir o hospedeiro. Pode executar os passos deste exemplo num anfitrião que tem apenas um adaptador de rede se instalar pela primeira vez o Adaptador Microsoft Loopback no seu servidor.
Parâmetros
-JobGroup
Especifica um identificador para uma série de comandos que funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada 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 ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha 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
Permite uma LAN virtual (VLAN) para utilização por máquinas virtuais num hospedeiro Hyper-V ou Citrix XenServer.
Formato de exemplo para um único VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
Exemplo formato 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 1-4094 a um adaptador de rede virtual numa máquina virtual ou a um adaptador de rede física num hospedeiro de máquina virtual.
Configure um VLanID num anfitrião Hiper-V, VMware ESX ou Citrix XenServer:
-- Num adaptador de rede física ligado externamente quando o modo VLan é Acesso.
Configure um VLanID num adaptador de rede virtual de uma máquina virtual:
- Ligado a um adaptador de rede física no hospedeiro, ou
- Ligado a uma rede virtual interna no hospedeiro.
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 um LAN virtual (VLAN) num anfitrião de máquina virtual suporta o tráfego através de um único VLAN (modo de acesso) ou através de vários VLANs (modo tronco). Valores válidos são: Acesso, Tronco.
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 um adaptador de rede física num hospedeiro Hiper-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 adaptador de rede física num hospedeiro ao qual as máquinas virtuais implantadas nesse hospedeiro podem ligar-se.
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 .