Set-SCVMHostNetworkAdapter
Altera as propriedades relacionadas com a rede para um adaptador de rede física num hospedeiro gerido por VMM.
Syntax
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>] 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 com a rede para um adaptador de rede físico num hospedeiro gerido pelo Virtual Machine Manager (VMM).
As propriedades que pode alterar com este cmdlet incluem:
- Definições VLAN: Pode utilizar os parâmetros VLAN para criar ou modificar um único VLAN ou vários VLANs. Para obter uma ilustração de como especificar as definições de VLAN, consulte os exemplos.
Para mais informações sobre VLANs e exemplos adicionais que ilustram as configurações VLAN, escreva Get-Help Add-SCVMHostNetworkAdapter -Detailed.
Exemplos
Exemplo 1: Criar uma nova rede virtual num adaptador de rede de anfitriões e especificar um ID 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 35O primeiro comando recebe o objeto anfitrião chamado VMHost02 e armazena o objeto na variável $VMHost.
O segundo comando obtém o objeto adaptador de rede do anfitrião com um nome que começa com "Intel(R) PRO/1000 em VMHost02 e armazena o objeto na variável $HostAdapter.
O terceiro comando cria uma rede virtual chamada VirtualNetwork01 em VMHost02 que está ligada ao adaptador de anfitrião armazenado em $HostAdapter.
O último comando permite um VLAN, define o modo de Acesso (que liga o tráfego internamente dentro de um único VLAN), e atribui ao adaptador de rede um VLANID de 35.
Nota: Este exemplo pressupõe que o seu anfitrião já está ligado a um VLAN ou, se não, 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.
Exemplo 2: Adicione etiquetas VLan a um adaptador de rede de anfitriões 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 $NewVLanTagsO primeiro comando recebe o objeto anfitrião chamado VMHost03 e armazena o objeto na variável $VMHost.
O segundo comando obtém o objeto adaptador de rede de anfitrião especificando o nome do adaptador e armazena o objeto na variável $VMHostNIC.
O terceiro comando utiliza a propriedade VlanTags do objeto adaptador de rede anfitrião ($VMHostNIC.VlanTags) e concatena uma nova gama de tags. A matriz atualizada mantém as VlanTags exisiting e adiciona as etiquetas listadas à matriz. O resultado da concatenação é armazenado em $NewVlanTags.
O último comando passa a nova lista de tags VLAN para o parâmetro VLANTrunkID do Set-VMHostNetworkAdapter. O parâmetro VLANMode deve especificar o valor "Tronco" sempre que o parâmetro VLANTrunkID for utilizado para modificar a lista de identificadores numéricos do tronco VLAN.
Parâmetros
-AddOrSetLogicalNetwork
Especifica uma rede lógica que será adicionada ou atualizada.
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailableForPlacement
Indica se o processo de colocação do VMM considera este hospedeiro ou este volume num hospedeiro como um possível local para implantar máquinas virtuais. Se este parâmetro estiver definido para $False, pode optar por implementar máquinas virtuais neste hospedeiro ou volume de qualquer forma. O valor predefinido é $True. Este parâmetro não se aplica aos anfitriões VMware ESX.
Quando este parâmetro for utilizado com adaptadores de rede, se definido para $False, a colocação não considerará as redes lógicas configuradas neste adaptador de rede para determinar se o hospedeiro é adequado para ligar uma máquina virtual.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Indica uma descrição do objeto especificado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableNetworkVirtualization
Especifica se a virtualização da rede está ativada. O valor predefinido é $False.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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 |
-RemoveLogicalNetwork
Especifica uma rede lógica que será removida.
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveUnassignedVLan
Especifica que os VLANs especificados serão removidos do porta-malas VLAN do adaptador se não estiverem associados a uma rede lógica.
| Type: | UInt16[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveUplinkPortProfileSet
Remove o perfil de porta de ligação uplink definido do adaptador de rede do anfitrião.
| Type: | SwitchParameter |
| 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 |
-SubnetVLan
Especifica uma ou mais sub-redes IP e conjuntos VLAN.
Para obter informações sobre a criação de um SubnetVLan, escreva Get-Help New-SCSubNetVLan.
| Type: | SubnetVLan[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UplinkPortProfileSet
Especifica um objeto definido por perfil de porta de ligação de uplink.
Para obter um objeto definido por perfil de porta de ligação, utilize o cmdlet Get-SCUplinkPortProfileSet .
| Type: | UplinkPortProfileSet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsedForManagement
Indica se o objeto é utilizado para gerir os anfitriões.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 - Formato de exemplo para vários VLANs:
-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Type: | Boolean |
| 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 .