Set-AzureRmVpnClientIpsecParameter

Referência

Módulo:: AzureRM.Network

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

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-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 do ponto a site queira usar determinada política ipsec personalizada para se conectar ao Gateway de VPN, o usuário precisa definir essa política de ipsec no Gateway de VPN primeiro. Set-AzureRmVpnClientIpsecParameter fornece uma maneira de fazer isso.

Exemplos

Exemplo 1: define uma política ipsec de vpn 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 de 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 em 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. Esse comando retorna o objeto de VpnClientIPsecParameters que mostra os parâmetros definidos.

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 a 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

-InputObject

O objeto gateaway de rede virtual

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

-ResourceGroupName

O nome do grupo de recursos.

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

-ResourceId

A ID do recurso do Azure.

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

-VirtualNetworkGatewayName

O nome do gateway de rede virtual.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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
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

PSVpnClientIPsecParameters

Parâmetros: VpnClientIPsecParameter (ByValue)

PSVirtualNetworkGateway

Parâmetros: InputObject (ByValue)

String

Saídas