Partilhar via


Set-AzureRmVpnClientIpsecParameter

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

Aviso

O módulo AzureRM PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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 políticas ipsec vpn padrão no Gateway. Caso o usuário Ponto a site queira 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 ipsec vpn personalizada para 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 vpn ipsec parameters de usar os valores passados de um ou todos os parâmetros que o usuário pode definir para qualquer gateway de rede virtual existente no ResourceGroup. Este 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 os parâmetros definidos.

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

O objeto gateaway da rede virtual

Tipo:PSVirtualNetworkGateway
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceId

A ID de recurso do Azure.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VirtualNetworkGatewayName

O nome do gateway de rede virtual.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VpnClientIPsecParameter

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

Tipo:PSVpnClientIPsecParameters
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSVpnClientIPsecParameters

Parâmetros: VpnClientIPsecParameter (ByValue)

PSVirtualNetworkGateway

Parâmetros: InputObject (ByValue)

String

Saídas

PSVpnClientIPsecParameters