Set-SCLogicalSwitchVirtualNetworkAdapter

  • Referência
Módulo:
VirtualMachineManager

Confirma qualquer alteração nas configurações em um VNIC (adaptador de rede virtual) existente que está conectado a um comutador lógico.

Syntax

Set-SCLogicalSwitchVirtualNetworkAdapter
   [-LogicalSwitchVirtualNetworkAdapter] <LogicalSwitchVirtualNetworkAdapter>
   [-EthernetAddressType <EthernetAddressType>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-VMSubnet <VMSubnet>]
   [-PortClassification <PortClassification>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   [-IsUsedForHostManagement <Boolean>]
   [-VMMServer <ServerConnection>]
   [-Name <String>]
   [-Description <String>]
   [-RemoveVMNetwork]
   [-RemoveVMSubnet]
   [-RemovePortClassification]
   [-RemoveIPv4AddressPool]
   [-RemoveIPv6AddressPool]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SCLogicalSwitchVirtualNetworkAdapter confirma alterações feitas em um adaptador de rede virtual existente que foi adicionado ao Perfil de Porta de Uplink como parte da definição de comutador lógico.

Exemplos

Exemplo 1: renomear um adaptador de rede virtual com comutador lógico

PS C:\> $HostVNic= Get-SCLogicalSwitchVirtualNetworkAdapter -Name "LogSw01_hostMgmt"
PS C:\> Set-SCLogicalSwitchVirtualNetworkAdapter -LogicalSwitchVirtualNetworkAdapter $HostVNic -Name "LogSw01_cluster"

O primeiro comando obtém um adaptador de rede virtual com comutador lógico usando o cmdlet Get-SCLogicalSwitchVirtualNetworkAdapter e o armazena na variável $HostVNic.

O segundo comando renomeia o adaptador em $HostVNic.

Parâmetros

-Description

Especifica uma descrição para o adaptador de rede virtual.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EthernetAddressType

Especifica um tipo de endereço Ethernet. Os valores aceitáveis para esse parâmetro são:

  • Dinâmico
  • Estático
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InheritsAddressFromPhysicalNetworkAdapter

Indica se o adaptador de rede herda seu endereço de um adaptador de rede físico.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressPool

Especifica um pool de endereços estáticos que contém endereços IPv4.

Type:StaticIPAddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressType

Especifica um tipo de endereço IPv4. Os valores aceitáveis para esse parâmetro são:

  • Dinâmico
  • Estático
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressPool

Especifica um pool de endereços estáticos que contém endereços IPv6.

Type:StaticIPAddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressType

Especifica um tipo de endereço IPv6. Os valores aceitáveis para esse parâmetro são:

  • Dinâmico
  • Estático
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsUsedForHostManagement

Indica se o adaptador de rede virtual é usado para gerenciamento de host.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalSwitchVirtualNetworkAdapter

Especifica um objeto de adaptador de rede virtual com comutador lógico.

Type:LogicalSwitchVirtualNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome do adaptador de rede.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortClassification

Especifica a classificação de porta do comutador ao qual o adaptador de rede virtual se conecta.

Type:PortClassification
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveIPv4AddressPool

Indica que esse cmdlet remove um pool de endereços IPv4.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveIPv6AddressPool

Indica que esse cmdlet remove um pool de endereços IPv6.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemovePortClassification

Indica que esse cmdlet remove uma classificação de porta.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveVMNetwork

Indica que esse cmdlet remove uma rede de máquina virtual.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveVMSubnet

Indica que esse cmdlet remove uma sub-rede de máquina virtual.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanEnabled

Indica se é necessário habilitar 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á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 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 uma VLanID em um host Hyper-V, VMware ESX ou Citrix XenServer em um adaptador de rede física externamente associado quando o modo VLan for Access.

Configure uma VLanID em um adaptador de rede virtual de uma máquina virtual associada a um adaptador de rede física no host ou vinculada a uma rede virtual interna no host.

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

-VMMServer

Especifica um objeto de servidor do VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMNetwork

Especifica um objeto de rede de VM.

Type:VMNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMSubnet

Especifica um objeto de sub-rede de máquina virtual.

Para obter um objeto VMSubnet , use o cmdlet Get-SCVMSubnet .

Type:VMSubnet
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False