Dela via


Set-AzureRmVpnClientIpsecParameter

Anger vpn ipsec-parametrarna för befintlig virtuell nätverksgateway.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten Set-AzureRmVpnClientIpsecParameter anger vpn ipsec-parametrarna för befintlig virtuell nätverksgateway. När virtuell nätverksgateway skapas anger den uppsättningen standardprinciper för vpn ipsec på gatewayen. Om punkt-till-plats-användare vill använda en viss anpassad ipsec-princip för att ansluta till VPN Gateway måste användaren först ange ipsec-principen på VPN Gateway. Set-AzureRmVpnClientIpsecParameter är ett sätt att göra det på.

Exempel

Exempel 1: Anger en anpassad vpn ipsec-princip till en befintlig virtuell nätverksgateway.

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

I det här exemplet anges en anpassad ipsec-princip för VPN till en befintlig virtuell nätverksgateway med namnet ContosoVirtualGateway från resursgruppen ContosoResourceGroup. Cmdleten New-AzureRmVpnClientIpsecParameter används för att skapa vpn ipsec-parameterobjektet för att använda de värden som skickas eller alla parametrar som användaren kan ange för en befintlig virtuell nätverksgateway i ResourceGroup. Det här skapade VpnClientIPsecParameters-objektet skickas till kommandot Set-AzureRmVpnClientIpsecParameter för att ange den angivna anpassade vpn ipsec-principen på virtuell nätverksgateway enligt exemplet ovan. Det här kommandot returnerar objektet vpnClientIPsecParameters som visar uppsättningsparametrar.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Det virtuella nätverksobjektet gateaway

Typ:PSVirtualNetworkGateway
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Resursgruppens namn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceId

Azure-resurs-ID:t.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VirtualNetworkGatewayName

Namnet på den virtuella nätverksgatewayen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VpnClientIPsecParameter

Ipsec-parametrar för VPN-klient. Det här parametervärdet kan konstrueras med ps-kommandot let:New-AzureRmVpnClientIpsecParameter

Typ:PSVpnClientIPsecParameters
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSVpnClientIPsecParameters

Parametrar: VpnClientIPsecParameter (ByValue)

PSVirtualNetworkGateway

Parametrar: InputObject (ByValue)

String

Utdata

PSVpnClientIPsecParameters