Freigeben über


Set-AzVpnClientIpsecParameter

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

Syntax

ByFactoryName (Standard)

Set-AzVpnClientIpsecParameter
    -VirtualNetworkGatewayName <String>
    -ResourceGroupName <String>
    -VpnClientIPsecParameter <PSVpnClientIPsecParameters>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByFactoryObject

Set-AzVpnClientIpsecParameter
    -VirtualNetworkGatewayName <String>
    -ResourceGroupName <String>
    -VpnClientIPsecParameter <PSVpnClientIPsecParameters>
    -InputObject <PSVirtualNetworkGateway>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByResourceId

Set-AzVpnClientIpsecParameter
    -VirtualNetworkGatewayName <String>
    -ResourceGroupName <String>
    -VpnClientIPsecParameter <PSVpnClientIPsecParameters>
    -ResourceId <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzVpnClientIpsecParameter 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-AzVpnClientIpsecParameter bietet eine Möglichkeit, dies zu tun.

Beispiele

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

$vpnclientipsecparams = New-AzVpnClientIpsecParameter -IpsecEncryption AES256 -IpsecIntegrity SHA256 -SALifeTime 86473 -SADataSize 429498 -IkeEncryption AES256 -IkeIntegrity SHA384 -DhGroup DHGroup2 -PfsGroup PFS2
$setvpnIpsecParams = Set-AzVpnClientIpsecParameter -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. New-AzVpnClientIpsecParameter Cmdlet wird verwendet, um das vpn ipsec-Parameterobjekt zu erstellen, das die übergebenen Werte eines oder aller Parameter verwendet, die der Benutzer für ein vorhandenes virtuelles Netzwerkgateway in ResourceGroup festlegen kann. Dieses erstellte VpnClientIPsecParameters-Objekt wird an Set-AzVpnClientIpsecParameter Befehl übergeben, um die angegebene benutzerdefinierte Vpn ipsec-Richtlinie auf dem virtuellen Netzwerkgateway festzulegen, wie im obigen Beispiel gezeigt. Dieser Befehl gibt ein Objekt von VpnClientIPsecParameters zurück, das festgelegte Parameter anzeigt.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Das Objekt des virtuellen Netzwerkgateways

Parametereigenschaften

Typ:PSVirtualNetworkGateway
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFactoryObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Der Ressourcengruppenname.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceId

Die Azure-Ressourcen-ID.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByResourceId
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-VirtualNetworkGatewayName

Der Name des virtuellen Netzwerkgateways.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VpnClientIPsecParameter

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

Parametereigenschaften

Typ:PSVpnClientIPsecParameters
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSVpnClientIPsecParameters

PSVirtualNetworkGateway

String

Ausgaben

PSVpnClientIPsecParameters