Partilhar via

Set-SCVirtualNetworkAdapterConfiguration

  • Referência
Módulo:
VirtualMachineManager

Modifica a configuração do adaptador de rede virtual contida em uma configuração de máquina virtual.

Sintaxe

Set-SCVirtualNetworkAdapterConfiguration
   [-IPv4PAAddressPool <StaticIPAddressPool>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-PinIPv4PAAddressPool <Boolean>]
   [-PinIPv4AddressPool <Boolean>]
   [-IPv6PAAddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-PinIPv6AddressPool <Boolean>]
   [-PinIPv6PAAddressPool <Boolean>]
   [-MACAddressPool <MACAddressPool>]
   [-PinMACAddressPool <Boolean>]
   [-IPv4PAAddress <String>]
   [-IPv4Address <String>]
   [-IPv6PAAddress <String>]
   [-IPv6Address <String>]
   [-MACAddress <String>]
   -VirtualNetworkAdapterConfiguration <VirtualNetworkAdapterConfiguration>
   [-VMSubnet <VMSubnet>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVirtualNetworkAdapterConfiguration modifica as informações de configuração do adaptador de rede virtual contidas em uma configuração de máquina virtual.

Exemplos

Exemplo 1: Definir as propriedades da configuração do adaptador de rede virtual para uma configuração de máquina virtual

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $VNAConfig = Get-SCVirtualNetworkAdapterConfiguration -VMConfiguration $VMConfig[0]
PS C:\> Set-SCVirtualNetworkAdapterConfiguration -VirtualNetworkAdapterConfiguration $VNAConfig -IPv4Address "10.255.234.155" -PinIPv4AddressPool $True

O primeiro comando obtém o objeto de configuração de serviço chamado Service01 e armazena o objeto na variável $ServiceConfig.

O segundo comando obtém a configuração da camada de computador para a configuração de serviço armazenada no $ServiceConfig e armazena o objeto na variável $TierConfig.

O terceiro comando obtém a configuração da máquina virtual para a configuração da camada de computador armazenada no $TierConfig e armazena o objeto na variável $VMConfig.

O quarto comando obtém a configuração do adaptador de rede virtual para a primeira configuração de máquina virtual armazenada no $VMConfig e armazena o objeto na variável $VNAConfig.

O último comando altera a propriedade IPv4Address da configuração do adaptador de rede armazenada no $VNAConfig e fixa o valor do endereço IP, o que impede que ele seja alterado durante o posicionamento.

Parâmetros

-IPv4Address

Especifica um endereço IPv4.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IPv4AddressPool

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

Tipo:StaticIPAddressPool
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IPv4PAAddress

Especifica um endereço IP do provedor no formato IPv4.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IPv4PAAddressPool

Especifica um pool de endereços IP do provedor que contém endereços IP no formato IPv4.

Tipo:StaticIPAddressPool
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IPv6Address

Especifica um endereço IPv6.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IPv6AddressPool

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

Tipo:StaticIPAddressPool
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IPv6PAAddress

Especifica um endereço IP do provedor no formato IPv6.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IPv6PAAddressPool

Especifica um pool de endereços IP do provedor que contém endereços IP no formato IPv6.

Tipo:StaticIPAddressPool
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MACAddress

Especifica o endereço MAC (controle de acesso à mídia) ou um conjunto de endereços MAC para um adaptador de rede físico ou virtual em um computador.

  • Exemplo de formato para um único endereço MAC: -MACAddress "00-15-5D-B4-DC-00"
  • Exemplo de formato para um conjunto de endereços MAC: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MACAddressPool

Especifica um pool de endereços MAC.

Tipo:MACAddressPool
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PinIPv4AddressPool

Indica se o pool de endereços IPv4 escolhido pelo usuário é mantido durante a configuração de implantação do serviço.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PinIPv4PAAddressPool

Indica se o pool de endereços do provedor IPv4 escolhido pelo usuário é mantido durante a configuração de implantação do serviço.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PinIPv6AddressPool

Indica se o pool de endereços IPv6 escolhido pelo usuário é mantido durante a configuração de implantação do serviço.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PinIPv6PAAddressPool

Indica se o pool de endereços do provedor IPv6 escolhido pelo usuário é mantido durante a configuração de implantação do serviço.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PinMACAddressPool

Indica se o pool de endereços MAC escolhido pelo usuário é mantido durante a configuração de implantação do serviço.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VirtualNetworkAdapterConfiguration

Especifica um objeto de configuração do adaptador de rede virtual.

Tipo:VirtualNetworkAdapterConfiguration
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMSubnet

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

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

Tipo:VMSubnet
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

VirtualNetworkAdapterConfiguration

Este cmdlet retorna um objeto VirtualNetworkAdapterConfiguration.