Set-AzureRmVpnClientIpsecParameter

Referenz

Modul:: AzureRM.Network

Legt die vpn ipsec-Parameter für vorhandenes virtuelles Netzwerkgateway fest.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

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

Beschreibung

Das Cmdlet Set-AzureRmVpnClientIpsecParameter legt die vpn ipsec-Parameter für ein vorhandenes virtuelles Netzwerkgateway fest. Wenn ein virtuelles Netzwerkgateway erstellt wird, wird der Satz der standardmäßigen VPN-IPSec-Richtlinien für Gateway festgelegt. Wenn Der Point to Site-Benutzer bestimmte benutzerdefinierte IPSec-Richtlinie verwenden möchte, um eine Verbindung mit dem VPN-Gateway herzustellen, muss der Benutzer diese ipsec-Richtlinie zuerst für DAS VPN-Gateway festlegen. Set-AzureRmVpnClientIpsecParameter bietet eine Möglichkeit, dies zu tun.

Beispiele

Beispiel 1: Legt eine benutzerdefinierte VPN-IPSEC-Richtlinie auf ein vorhandenes virtuelles Netzwerkgateway fest.

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

In diesem Beispiel wird eine benutzerdefinierte VPN-IPSEC-Richtlinie auf ein vorhandenes virtuelles Netzwerkgateway namens ContosoVirtualGateway aus der Ressourcengruppe "ContosoResourceGroup" festgelegt. Das Cmdlet New-AzureRmVpnClientIpsecParameter wird verwendet, um das vpn ipsec-Parameterobjekt zu erstellen, das die übergebenen Werte eines oder aller Parameter verwendet, die der Benutzer für jedes vorhandene virtuelle Netzwerkgateway in ResourceGroup festlegen kann. Dieses erstellte VpnClientIPsecParameters-Objekt wird an set-AzureRmVpnClientIpsecParameter-Befehl übergeben, um die angegebene benutzerdefinierte Vpn ipsec-Richtlinie für das virtuelle Netzwerkgateway festzulegen, wie im obigen Beispiel gezeigt. Dieser Befehl gibt ein Objekt von VpnClientIPsecParameters zurück, das festgelegte Parameter anzeigt.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-InputObject

Das Gateaway-Objekt des virtuellen Netzwerks

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

-ResourceGroupName

Der Name der Ressourcengruppe.

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

-ResourceId

Die Azure-Ressourcen-ID.

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

-VirtualNetworkGatewayName

Der Name des virtuellen Netzwerkgateways.

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

-VpnClientIPsecParameter

Ipsec-Parameter des VPN-Clients. Dieser Parameterwert kann mithilfe des PS-Befehls let:New-AzureRmVpnClientIpsecParameter erstellt werden.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

PSVpnClientIPsecParameters

Parameter: VpnClientIPsecParameter (ByValue)

PSVirtualNetworkGateway

Parameter: InputObject (ByValue)

String

Ausgaben