Set-SCVirtualNetworkAdapterConfiguration
Modifica a configuração do adaptador de rede virtual contida em uma configuração de máquina virtual.
Syntax
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.
Type: | String |
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 |
-IPv4PAAddress
Especifica um endereço IP do provedor no formato IPv4.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IPv4PAAddressPool
Especifica um pool de endereços IP do provedor que contém endereços IP no formato IPv4.
Type: | StaticIPAddressPool |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IPv6Address
Especifica um endereço IPv6.
Type: | String |
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 |
-IPv6PAAddress
Especifica um endereço IP do provedor no formato IPv6.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IPv6PAAddressPool
Especifica um pool de endereços IP do provedor que contém endereços IP no formato IPv6.
Type: | StaticIPAddressPool |
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 |
-MACAddress
Especifica o endereço MAC (controle de acesso à 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"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MACAddressPool
Especifica um pool de endereços MAC.
Type: | MACAddressPool |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PinIPv4AddressPool
Indica se o pool de endereços IPv4 escolhido pelo usuário é retido durante a configuração de implantação do serviço.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PinIPv4PAAddressPool
Indica se o pool de endereços do provedor IPv4 escolhido pelo usuário é retido durante a configuração de implantação do serviço.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PinIPv6AddressPool
Indica se o pool de endereços IPv6 escolhido pelo usuário é retido durante a configuração de implantação do serviço.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PinIPv6PAAddressPool
Indica se o pool de endereços do provedor IPv6 escolhido pelo usuário é retido durante a configuração de implantação do serviço.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PinMACAddressPool
Indica se o pool de endereços MAC escolhido pelo usuário é retido durante a configuração de implantação do serviço.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 |
-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 |
-VirtualNetworkAdapterConfiguration
Especifica um objeto de configuração de adaptador de rede virtual.
Type: | VirtualNetworkAdapterConfiguration |
Position: | Named |
Default value: | None |
Required: | True |
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: | False |
Accept wildcard characters: | False |
Saídas
VirtualNetworkAdapterConfiguration
Esse cmdlet retorna um objeto VirtualNetworkAdapterConfiguration .