Set-AzureRmVpnClientIpsecParameter

Définit les paramètres ipsec vpn pour la passerelle de réseau virtuel existante.

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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

L’applet de commande Set-AzureRmVpnClientIpsecParameter définit les paramètres ipsec vpn pour la passerelle de réseau virtuel existante. Lorsque la passerelle de réseau virtuel est créée, elle définit l’ensemble de stratégies ipsec vpn par défaut sur la passerelle. Dans le cas où l’utilisateur point à site souhaite utiliser une stratégie ipsec personnalisée pour se connecter à passerelle VPN, l’utilisateur doit d’abord définir cette stratégie ipsec sur passerelle VPN. Set-AzureRmVpnClientIpsecParameter offre un moyen de le faire.

Exemples

Exemple 1 : définit une stratégie ipsec vpn personnalisée sur une passerelle de réseau virtuel existante.

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

Cet exemple montre comment définir une stratégie ipsec vpn personnalisée sur une passerelle de réseau virtuel existante nommée ContosoVirtualGateway à partir du groupe de ressources nommé ContosoResourceGroup. L’applet de commande New-AzureRmVpnClientIpsecParameter permet de créer l’objet de paramètres ipsec vpn de l’utilisation des valeurs passées d’un ou de tous les paramètres que l’utilisateur peut définir pour n’importe quelle passerelle de réseau virtuel existante dans ResourceGroup. Cet objet VpnClientIPsecParameters créé est transmis à la commande Set-AzureRmVpnClientIpsecParameter pour définir la stratégie personnalisée ipsec vpn spécifiée sur la passerelle de réseau virtuel, comme illustré dans l’exemple ci-dessus. Cette commande retourne l’objet vpnClientIPsecParameters qui affiche les paramètres définis.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Objet gateaway de réseau virtuel

Type:PSVirtualNetworkGateway
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Nom du groupe de ressources.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceId

ID de ressource Azure.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VirtualNetworkGatewayName

Nom de la passerelle de réseau virtuel.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VpnClientIPsecParameter

Paramètres ipsec du client VPN. Cette valeur de paramètre peut être construite à l’aide de la commande PS let :New-AzureRmVpnClientIpsecParameter

Type:PSVpnClientIPsecParameters
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSVpnClientIPsecParameters

Paramètres : VpnClientIPsecParameter (ByValue)

PSVirtualNetworkGateway

Paramètres : InputObject (ByValue)

String

Sorties

PSVpnClientIPsecParameters