Set-SCVMHostNetworkAdapter
Altera as propriedades relacionadas à rede de um adaptador de rede física em um host gerenciado pelo VMM.
Sintaxe
LogicalNetwork (Padrão)
Set-SCVMHostNetworkAdapter
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-Description <String>]
[-VLanMode <VlanMode>]
[-AvailableForPlacement <Boolean>]
[-UsedForManagement <Boolean>]
[-SubnetVLan <SubnetVLan[]>]
[-RemoveUnassignedVLan <UInt16[]>]
[-AddOrSetLogicalNetwork <LogicalNetwork>]
[-RemoveLogicalNetwork <LogicalNetwork>]
[-EnableNetworkVirtualization <Boolean>]
[-UplinkPortProfileSet <UplinkPortProfileSet>]
[-RemoveUplinkPortProfileSet]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Manual
Set-SCVMHostNetworkAdapter
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-Description <String>]
[-VLanEnabled <Boolean>]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-AvailableForPlacement <Boolean>]
[-UsedForManagement <Boolean>]
[-RemoveUnassignedVLan <UInt16[]>]
[-EnableNetworkVirtualization <Boolean>]
[-UplinkPortProfileSet <UplinkPortProfileSet>]
[-RemoveUplinkPortProfileSet]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
O cmdlet Set-SCVMHostNetworkAdapter altera as propriedades relacionadas à rede para um adaptador de rede física em um host gerenciado pelo Virtual Machine Manager (VMM).
As propriedades que você pode alterar com esse cmdlet incluem:
- Configurações de VLAN: Você pode usar os parâmetros de VLAN para criar ou modificar uma única VLAN ou várias VLANs. Para obter uma ilustração de como especificar as configurações de VLAN, consulte os exemplos.
Para obter mais informações sobre VLANs e exemplos adicionais que ilustram as configurações de VLAN, digite Get-Help Add-SCVMHostNetworkAdapter -Detailed.
Exemplos
Exemplo 1: criar uma nova rede virtual em um adaptador de rede host e especificar uma ID de VLAN para a rede virtual
PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost | where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35
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 do adaptador de rede do host com um nome que começa com "Intel(R) PRO/1000 no VMHost02 e armazena o objeto na variável $HostAdapter.
O terceiro comando cria uma rede virtual chamada VirtualNetwork01 no VMHost02 que está associada ao adaptador de host armazenado no $HostAdapter.
O último comando habilita uma VLAN, define o modo como Access (que roteia o tráfego internamente em uma única VLAN) e atribui ao adaptador de rede uma VLANID de 35.
Observação: este exemplo pressupõe que seu host já esteja conectado a uma VLAN ou, caso contrário, 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 esteja disponível para o servidor VMM impedirá que o VMM gerencie o host.
Exemplo 2: Adicionar marcas VLan a um adaptador de rede de host configurado no modo Tronco
PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags
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 do adaptador de rede do host especificando o nome do adaptador e armazena o objeto na variável $VMHostNIC.
O terceiro comando usa a propriedade VlanTags do objeto do adaptador de rede do host ($VMHostNIC.VlanTags) e concatena uma nova matriz de tags. A matriz atualizada retém as VlanTags existentes e adiciona as marcas listadas à matriz. O resultado da concatenação é armazenado em $NewVlanTags.
O último comando passa a nova lista de marcas de VLAN para o parâmetro VLANTrunkID de Set-VMHostNetworkAdapter. O parâmetro VLANMode deve especificar o valor "Trunk" sempre que o parâmetro VLANTrunkID for usado para modificar a lista de identificadores numéricos de tronco VLAN.
Parâmetros
-AddOrSetLogicalNetwork
Especifica uma rede lógica que será adicionada ou atualizada.
Propriedades do parâmetro
| Tipo: | LogicalNetwork |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
LogicalNetwork
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AvailableForPlacement
Indica se o processo de posicionamento do VMM considera esse host ou esse volume em um host como qualificado como um possível local no qual implantar máquinas virtuais. Se esse parâmetro estiver definido como $False, você poderá optar por implantar máquinas virtuais nesse host ou volume de qualquer maneira. O valor padrão é $True. Esse parâmetro não se aplica a hosts VMware ESX.
Quando esse parâmetro é usado com adaptadores de rede, se definido como $False, o posicionamento não considerará as redes lógicas configuradas nesse adaptador de rede para determinar se o host é adequado para conectar uma máquina virtual.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Description
Declara uma descrição para o objeto especificado.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-EnableNetworkVirtualization
Especifica se a virtualização de rede está habilitada. O valor padrão é $False.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-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.
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-JobVariable
Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RemoveLogicalNetwork
Especifica uma rede lógica que será removida.
Propriedades do parâmetro
| Tipo: | LogicalNetwork |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
LogicalNetwork
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RemoveUnassignedVLan
Especifica que as VLANs especificadas serão removidas do tronco VLAN do adaptador se não estiverem associadas a uma rede lógica.
Propriedades do parâmetro
| Tipo: | UInt16[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RemoveUplinkPortProfileSet
Remove o perfil de porta de uplink definido do adaptador de rede do host.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SubnetVLan
Especifica uma ou mais sub-redes IP e conjuntos de VLAN.
Para obter informações sobre como criar um SubnetVLan, digite Get-Help New-SCSubNetVLan.
Propriedades do parâmetro
| Tipo: | SubnetVLan[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
LogicalNetwork
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UplinkPortProfileSet
Especifica um objeto de conjunto de perfis de porta de uplink.
Para obter um objeto de conjunto de perfis de porta de uplink, use o cmdlet Get-SCUplinkPortProfileSet .
Propriedades do parâmetro
| Tipo: | UplinkPortProfileSet |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UsedForManagement
Indica se o objeto é usado para gerenciar hosts.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-VLanEnabled
Habilita uma LAN virtual (VLAN) para uso por máquinas virtuais em um host Hyper-V ou Citrix XenServer.
- Exemplo de formato para uma única VLAN:
-VLANEnabled -VLANMode "Access" -VLANID 35 - Exemplo de formato para várias VLANs:
-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Manual
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 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ísica no host ou
- Associado a uma rede virtual interna no host.
Formato de exemplo: -VLanEnabled -VLanMode "Access" -VLANID 35
Propriedades do parâmetro
| Tipo: | UInt16 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Manual
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-VLanMode
Especifica se uma LAN virtual (VLAN) em um host de máquina virtual oferece suporte ao 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 do parâmetro
| Tipo: | VlanMode |
| Valor padrão: | None |
| Valores aceitos: | Access, Trunk, Invalid |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-VLanTrunkID
Atribui uma lista de identificadores numéricos no intervalo de 1 a 4094 a um adaptador de rede física em um host Hyper-V.
Formato de exemplo: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Propriedades do parâmetro
| Tipo: | UInt16[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Manual
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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
Propriedades do parâmetro
| Tipo: | HostNetworkAdapter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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
Esse cmdlet retorna um objeto VMHostNetworkAdapter .