Share via


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.

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

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
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

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

-InputObject

Objet gateaway de réseau virtuel

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

-ResourceGroupName

Nom du groupe de ressources.

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

-ResourceId

ID de ressource Azure.

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

-VirtualNetworkGatewayName

Nom de la passerelle de réseau virtuel.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

PSVpnClientIPsecParameters

Paramètres : VpnClientIPsecParameter (ByValue)

PSVirtualNetworkGateway

Paramètres : InputObject (ByValue)

String

Sorties

PSVpnClientIPsecParameters