Compartilhar via


Set-SCVirtualNetworkAdapterConfiguration

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 em $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 em $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 em $VMConfig e armazena o objeto na variável $VNAConfig.

O último comando altera a propriedade IPv4Address da configuração do adaptador de rede armazenada em $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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPv4AddressPool

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

Tipo:StaticIPAddressPool
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPv4PAAddress

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPv4PAAddressPool

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

Tipo:StaticIPAddressPool
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPv6Address

Especifica um endereço IPv6.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPv6AddressPool

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

Tipo:StaticIPAddressPool
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPv6PAAddress

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPv6PAAddressPool

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

Tipo:StaticIPAddressPool
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MACAddress

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

  • Formato de exemplo para um único endereço MAC: -MACAddress "00-15-5D-B4-DC-00"
  • Formato de exemplo para um conjunto de endereços MAC: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MACAddressPool

Especifica um pool de endereços MAC.

Tipo:MACAddressPool
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PinMACAddressPool

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

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualNetworkAdapterConfiguration

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

Tipo:VirtualNetworkAdapterConfiguration
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMSubnet

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

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

Tipo:VMSubnet
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

VirtualNetworkAdapterConfiguration

Esse cmdlet retorna um objeto VirtualNetworkAdapterConfiguration.