Set-SCNATConnection
Atualizações uma conexão NAT.
Syntax
Set-SCNATConnection
[-VMMServer <ServerConnection>]
[-NATConnection] <NATConnection>
[-Name <String>]
[-Description <String>]
[-Status <GatewayConnectionStatus>]
[-MaximumBandwidthInboundKbps <UInt64>]
[-MaximumBandwidthOutboundKbps <UInt64>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Description
O cmdlet Set-SCNATConnection atualiza uma conexão NAT (conversão de endereço de rede).
Exemplos
Exemplo 1: alterar o nome e a descrição da conexão NAT de uma rede de máquina virtual
PS C:\> $VmNetwork = Get-SCVMNetwork -Name "NAT_VMNetwork"
PS C:\> $NatConnection = Get-SCNATConnection -VMNetwork $VmNetwork
PS C:\> Set-SCNATConnection -NATConnection $NatConnection -Name "NatConn_VMNAT1" -Description "NAT Connection for VM Network1"O primeiro comando obtém a rede da máquina virtual pelo nome e a armazena na variável $VmNetwork.
O segundo comando obtém a conexão NAT para a rede de máquina virtual e a armazena na variável $NatConnection.
O terceiro comando altera o nome da conexão NAT para NatConn_VMNAT1 e sua descrição para a Conexão NAT para Rede de VM1.
Exemplo 2: alterar o status da conexão NAT de uma rede de máquina virtual
PS C:\> $VmNetwork = Get-SCVMNetwork -Name "NAT_VMNetwork"
PS C:\> $NatConnection = Get-SCNATConnection -VMNetwork $VmNetwork
PS C:\> Set-SCNATConnection -NATConnection $NatConnection -Status Disabled"O primeiro comando obtém a rede da máquina virtual pelo nome e a armazena na variável $VmNetwork.
O segundo comando obtém a conexão NAT para a rede de máquina virtual e a armazena na variável $NatConnection.
O terceiro comando altera o status da conexão NAT para Desabilitado.
Parâmetros
-Description
Especifica uma descrição para a conexão NAT.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica uma variável na qual o progresso do trabalho é rastreado e armazenado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumBandwidthInboundKbps
Especifica, em kbps, a largura de banda máxima de entrada.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumBandwidthOutboundKbps
Especifica, em kbps, a largura de banda máxima de saída.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica o nome de um objeto de rede.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NATConnection
Especifica um objeto de conexão NAT.
| Type: | NATConnection |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.
| Type: | UserRole |
| 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 |
-Status
Especifica um status de conexão de gateway. Os valores aceitáveis para esse parâmetro são:
- Erro
- Habilitada
- Desabilitado
| Type: | GatewayConnectionStatus |
| Accepted values: | Error, Enabled, Disabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Especifica um objeto de servidor do VMM (Virtual Machine Manager).
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |