Dela via

Set-AzureRmVirtualNetworkGateway

  • Referens
Modul:
AzureRM.Network

Uppdaterar en 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-AzureRmVirtualNetworkGateway
   -VirtualNetworkGateway <PSVirtualNetworkGateway>
   [-GatewaySku <String>]
   [-GatewayDefaultSite <PSLocalNetworkGateway>]
   [-VpnClientAddressPool <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientProtocol <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientRootCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRootCertificate]>]
   [-VpnClientRevokedCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate]>]
   [-VpnClientIpsecPolicy <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSIpsecPolicy]>]
   [-Asn <UInt32>]
   [-PeerWeight <Int32>]
   [-EnableActiveActiveFeature]
   [-DisableActiveActiveFeature]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmVirtualNetworkGateway
   -VirtualNetworkGateway <PSVirtualNetworkGateway>
   [-GatewaySku <String>]
   [-GatewayDefaultSite <PSLocalNetworkGateway>]
   [-VpnClientAddressPool <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientProtocol <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientRootCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRootCertificate]>]
   [-VpnClientRevokedCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate]>]
   [-VpnClientIpsecPolicy <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSIpsecPolicy]>]
   [-Asn <UInt32>]
   [-PeerWeight <Int32>]
   [-EnableActiveActiveFeature]
   [-DisableActiveActiveFeature]
   -RadiusServerAddress <String>
   -RadiusServerSecret <SecureString>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten Set-AzureRmVirtualNetworkGateway uppdaterar en virtuell nätverksgateway.

Exempel

Exempel 1: Ange måltillståndet för en virtuell nätverksgateway

PS C:\>$Gateway = Get-AzureRmVirtualNetworkGateway -ResourceGroupName "ResourceGroup001" -Name "Gateway001"
PS C:\> Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $Gateway -Asn 1337

Det första kommandot hämtar en virtuell nätverksgateway med namnet Gateway01 som tillhör resursgruppen ResourceGroup001 och lagrar den till variabeln med namnet $Gateway Det andra kommandot anger måltillståndet för den virtuella nätverksgatewayen som lagras i variabeln $Gateway. Kommandot anger även ASN till 1337.

Exempel 2: Ange måltillståndet för en virtuell nätverksgateway

PS C:\>$Gateway = Get-AzureRmVirtualNetworkGateway -ResourceGroupName "ResourceGroup001" -Name "Gateway001"
PS C:\> $vpnclientipsecpolicy = New-AzureRmVpnClientIpsecPolicy -IpsecEncryption AES256 -IpsecIntegrity SHA256 -SALifeTimeSeconds 86472 -SADataSizeKilobytes 429497 -IkeEncryption AES256 -IkeIntegrity SHA256 -DhGroup DHGroup2 -PfsGroup None
PS C:\> $gateway = Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $Gateway -VpnClientIpsecPolicy $vpnclientipsecpolicy

Det första kommandot hämtar en virtuell nätverksgateway med namnet Gateway01 som tillhör resursgruppen ResourceGroup001 och lagrar den till variabeln med namnet $Gateway Det andra kommandot skapar vpn ipsec-principobjektet enligt angivna ipsec-parametrar. Det tredje kommandot anger måltillståndet för den virtuella nätverksgatewayen som lagras i variabeln $Gateway. Kommandot anger också den anpassade vpn ipsec-principen som anges i $vpnclientipsecpolicy-objektet på virtuell nätverksgateway.

Parametrar

-AsJob

Kör cmdlet i bakgrunden

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

-Asn

Anger den virtuella nätverksgatewayen Autonomt systemnummer (ASN) som används för att konfigurera BGP-sessioner (Border Gateway Protocol) i IPsec-tunnlar.

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

-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

-DisableActiveActiveFeature

Inaktiverar aktiv-aktiv-funktionen.

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

-EnableActiveActiveFeature

Aktiverar aktiv-aktiv-funktionen.

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

-GatewayDefaultSite

Anger den standardplats som ska användas för tvingad tunneltrafik. Om en standardplats anges dirigeras all Internettrafik från gatewayens virtuella privata nätverk (VPN) till den platsen.

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

-GatewaySku

Anger lagerhållningsenhet (SKU) för den virtuella nätverksgatewayen. De acceptabla värdena för den här parametern är:

  • Basic
  • Standard
  • HighPerformance
  • VpnGw1
  • VpnGw2
  • VpnGw3
  • VpnGw1AZ
  • VpnGw2AZ
  • VpnGw3AZ
  • ErGw1AZ
  • ErGw2AZ
  • ErGw3AZ
Typ:String
Godkända värden:Basic, Standard, HighPerformance, UltraPerformance, VpnGw1, VpnGw2, VpnGw3, VpnGw1AZ, VpnGw2AZ, VpnGw3AZ, ErGw1AZ, ErGw2AZ, ErGw3AZ
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PeerWeight

Anger vikten som läggs till i vägar som har lärts över BGP från den här virtuella nätverksgatewayen

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

-RadiusServerAddress

P2S extern radius-serveradress.

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

-RadiusServerSecret

P2S extern radius-serverhemlighet.

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

-VirtualNetworkGateway

Anger det virtuella nätverksgatewayobjektet som basändringarna ska utföras från. Du kan använda cmdleten Get-AzureRmVirtualNetworkGateway för att hämta det virtuella nätverksgatewayobjektet.

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

-VpnClientAddressPool

Anger det adressutrymme som den här cmdleten använder för att allokera VPN-klientens IP-adresser från. Detta bör inte överlappa med virtuella nätverk eller lokala intervall.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VpnClientIpsecPolicy

En lista över IPSec-principer för P2S VPN-klienttunnelprotokoll.

Typ:List<T>[PSIpsecPolicy]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VpnClientProtocol

En lista över P2S VPN-klienttunnelprotokoll

Typ:List<T>[String]
Godkända värden:SSTP, IkeV2, OpenVPN
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VpnClientRevokedCertificates

Anger en lista över återkallade VPN-klientcertifikat. En VPN-klient som presenterar ett certifikat som matchar något av dessa tas bort.

Typ:List<T>[PSVpnClientRevokedCertificate]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VpnClientRootCertificates

Anger en lista över VPN-klientrotcertifikat som ska användas för VPN-klientautentisering. Anslutning av VPN-klienter måste innehålla certifikat som genererats från något av dessa rotcertifikat.

Typ:List<T>[PSVpnClientRootCertificate]
Position:Named
Standardvärde:None
Obligatorisk:False
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

PSVirtualNetworkGateway

Parametrar: VirtualNetworkGateway (ByValue)

String

PSLocalNetworkGateway

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSVpnClientRootCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSIpsecPolicy, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

UInt32

Int32

SecureString

Utdata

PSVirtualNetworkGateway

Kommentarer

  • Nyckelord: azure, azurerm, arm, resource, management, manager, network, networking