Share via


Set-AzureRmVpnClientIpsecParameter

Define os parâmetros vpn ipsec para o gateway de rede virtual existente.

Aviso

O módulo do PowerShell do AzureRM foi oficialmente preterido em 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 é mais mantido ou suportado, 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.

Syntax

Set-AzureRmVpnClientIpsecParameter
   -VirtualNetworkGatewayName <String>
   -ResourceGroupName <String>
   -VpnClientIPsecParameter <PSVpnClientIPsecParameters>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmVpnClientIpsecParameter
   -VirtualNetworkGatewayName <String>
   -ResourceGroupName <String>
   -VpnClientIPsecParameter <PSVpnClientIPsecParameters>
   -InputObject <PSVirtualNetworkGateway>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmVpnClientIpsecParameter
   -VirtualNetworkGatewayName <String>
   -ResourceGroupName <String>
   -VpnClientIPsecParameter <PSVpnClientIPsecParameters>
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzureRmVpnClientIpsecParameter define os parâmetros vpn ipsec para o gateway de rede virtual existente. Quando o gateway de rede virtual é criado, ele define o conjunto de diretivas ipsec vpn padrão no Gateway. Caso o usuário do Point to site deseje usar determinada política ipsec personalizada para se conectar ao Gateway VPN, o usuário precisa definir essa política ipsec no Gateway VPN primeiro. Set-AzureRmVpnClientIpsecParameter fornece uma maneira de fazer isso.

Exemplos

Exemplo 1: Define uma política vpn ipsec personalizada para o gateway de rede virtual existente.

PS C:\>$vpnclientipsecparams = New-AzureRmVpnClientIpsecParameter -IpsecEncryption AES256 -IpsecIntegrity SHA256 -SALifeTime 86473 -SADataSize 429498 -IkeEncryption AES256 -IkeIntegrity SHA384 -DhGroup DHGroup2 -PfsGroup PFS2
PS C:\> $setvpnIpsecParams = Set-AzureRmVpnClientIpsecParameter -VirtualNetworkGatewayName "ContosoLocalGateway" -ResourceGroupName "ContosoResourceGroup" -VpnClientIPsecParameter $vpnclientipsecparams

Este exemplo define a política ipsec vpn personalizada para o gateway de rede virtual existente chamado ContosoVirtualGateway do grupo de recursos chamado ContosoResourceGroup. O cmdlet New-AzureRmVpnClientIpsecParameter é usado para criar o objeto de parâmetros vpn ipsec usando os valores de um ou todos os parâmetros passados que o usuário pode definir para qualquer gateway de rede virtual existente no ResourceGroup. Esse objeto VpnClientIPsecParameters criado é passado para o comando Set-AzureRmVpnClientIpsecParameter para definir a política personalizada Vpn ipsec especificada no gateway de rede virtual, conforme mostrado no exemplo acima. Este comando retorna o objeto de VpnClientIPsecParameters que mostra parâmetros definidos.

Parâmetros

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

O objeto gateaway de rede virtual

Type:PSVirtualNetworkGateway
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

O nome do grupo de recursos.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

A ID do recurso do Azure.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualNetworkGatewayName

O nome do gateway de rede virtual.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VpnClientIPsecParameter

Parâmetros ipsec do cliente VPN. Esse valor de parâmetro pode ser construído usando o comando PS let:New-AzureRmVpnClientIpsecParameter

Type:PSVpnClientIPsecParameters
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSVpnClientIPsecParameters

Parâmetros: VpnClientIPsecParameter (ByValue)

PSVirtualNetworkGateway

Parâmetros: InputObject (ByValue)

String

Saídas

PSVpnClientIPsecParameters