Compartilhar via


Set-AzureRmVirtualNetworkGatewayVpnClientConfig

Define o pool de endereços do cliente VPN para um gateway de rede virtual.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Set-AzureRmVirtualNetworkGatewayVpnClientConfig
   -VirtualNetworkGateway <PSVirtualNetworkGateway>
   -VpnClientAddressPool <System.Collections.Generic.List`1[System.String]>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmVirtualNetworkGatewayVpnClientConfig
   -VirtualNetworkGateway <PSVirtualNetworkGateway>
   -VpnClientAddressPool <System.Collections.Generic.List`1[System.String]>
   -RadiusServerAddress <String>
   -RadiusServerSecret <SecureString>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzureRmVirtualNetworkVpnClientConfig configura o pool de endereços do cliente para um gateway de rede virtual. Os clientes VPN (rede virtual privada) que se conectam a esse gateway receberão um endereço IP desse pool de endereços.

Exemplos

Exemplo 1: Atribuir um pool de endereços de cliente VPN a um gateway de rede virtual

PS C:\>$Gateway = Get-AzureRmVirtualNetworkGateway -Name "ContosoVirtualGateway"
PS C:\> Set-AzureRmVirtualNetworkGatewayVpnClientConfig -VirtualNetworkGateway $Gateway -VpnClientAddressPool "10.0.0.0/16"

Este exemplo atribui um pool de endereços de cliente VPN a um gateway de rede virtual chamado ContosoVirtualGateway. O primeiro comando cria uma referência de objeto para o gateway e o objeto é armazenado em uma variável chamada $Gateway. O segundo comando no exemplo usa o cmdlet Set-AzureRmVirtualNetworkGatewayVpnClientConfig para atribuir o pool de endereços 10.0.0.0/16 a ContosoVirtualGateway.

Exemplo 2: Configurar a autenticação baseada em raio externo no gateway existente

PS C:\>$Gateway = Get-AzureRmVirtualNetworkGateway -Name "ContosoVirtualGateway"
PS C:\> $Secure_String_Pwd = ConvertTo-SecureString "TestRadiusServerPassword" -AsPlainText -Force
PS C:\> Set-AzureRmVirtualNetworkGatewayVpnClientConfig -VirtualNetworkGateway $Gateway -VpnClientAddressPool "10.0.0.0/16" -RadiusServerAddress "TestRadiusServer" -RadiusServerSecret $Secure_String_Pwd

Este exemplo atribui um pool de endereços de cliente VPN a um gateway de rede virtual chamado ContosoVirtualGateway. O primeiro comando cria uma referência de objeto para o gateway e o objeto é armazenado em uma variável chamada $Gateway. O segundo comando no exemplo usa o cmdlet Set-AzureRmVirtualNetworkGatewayVpnClientConfig para atribuir o pool de endereços 10.0.0.0/16 a ContosoVirtualGateway. Ele também configura o servidor radius externo "TestRadiusServer" para ser usado para autenticação para clientes vpn.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RadiusServerAddress

Endereço do servidor Radius externo P2S.

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

-RadiusServerSecret

Segredo do servidor Radius externo P2S.

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

-VirtualNetworkGateway

Especifica uma referência de objeto para o gateway de rede virtual que contém as definições de configuração do cliente VPN que esse cmdlet modifica. Você pode criar uma referência de objeto para um gateway de rede virtual usando o Get-AzureRmVirtualNetworkGateway e especificando o nome do gateway.

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

-VpnClientAddressPool

Especifica os endereços IP a serem atribuídos aos clientes que se conectam a esse gateway

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

PSVirtualNetworkGateway

Parâmetros: VirtualNetworkGateway (ByValue)

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

String

SecureString

Saídas

PSVirtualNetworkGateway