Set-AzureRmVirtualNetworkGateway

  • Reference
Modul:
AzureRM.Network

Aktualizace bránu virtuální sítě.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

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

Rutina Set-AzureRmVirtualNetworkGateway aktualizuje bránu virtuální sítě.

Příklady

Příklad 1: Nastavení stavu cíle brány virtuální sítě

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

První příkaz získá bránu virtuální sítě s názvem Gateway01, která patří do skupiny prostředků ResourceGroup001, a uloží ji do proměnné s názvem $Gateway Druhý příkaz nastaví stav cíle brány virtuální sítě uložené v proměnné $Gateway. Příkaz také nastaví ASN na 1337.

Příklad 2: Nastavení stavu cíle brány virtuální sítě

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

První příkaz získá bránu virtuální sítě s názvem Gateway01, která patří do skupiny prostředků ResourceGroup001, a uloží ji do proměnné s názvem $Gateway Druhý příkaz vytvoří objekt zásad ipsec vpn podle zadaných parametrů ipsec. Třetí příkaz nastaví stav cíle brány virtuální sítě uložené v proměnné $Gateway. Příkaz také nastaví vlastní zásadu iPsec vpn zadanou v objektu $vpnclientipsecpolicy v bráně virtuální sítě.

Parametry

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Asn

Určuje číslo autonomního systému (ASN) brány virtuální sítě, které se používá k nastavení relací protokolu BGP (Border Gateway Protocol) uvnitř tunelů IPsec.

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisableActiveActiveFeature

Zakáže funkci aktivní-aktivní.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableActiveActiveFeature

Povolí funkci aktivní-aktivní.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GatewayDefaultSite

Určuje výchozí lokalitu, která se má použít pro vynucené tunelování. Pokud je zadána výchozí lokalita, veškerý internetový provoz z virtuální privátní sítě (VPN) brány se na tuto lokalitu směruje.

Typ:PSLocalNetworkGateway
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-GatewaySku

Určuje skladovou jednotku (SKU) brány virtuální sítě. Tento parametr přijímá tyto hodnoty:

  • Basic
  • Standard
  • HighPerformance
  • VpnGw1
  • VpnGw2
  • VpnGw3
  • VpnGw1AZ
  • VpnGw2AZ
  • VpnGw3AZ
  • ErGw1AZ
  • ErGw2AZ
  • ErGw3AZ
Typ:String
Přípustné hodnoty:Basic, Standard, HighPerformance, UltraPerformance, VpnGw1, VpnGw2, VpnGw3, VpnGw1AZ, VpnGw2AZ, VpnGw3AZ, ErGw1AZ, ErGw2AZ, ErGw3AZ
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PeerWeight

Určuje váhu přidanou do tras získaných přes protokol BGP z této brány virtuální sítě.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RadiusServerAddress

Adresa externího serveru radius P2S.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RadiusServerSecret

Tajný klíč externího serveru radius P2S.

Typ:SecureString
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VirtualNetworkGateway

Určuje objekt brány virtuální sítě, ze které se mají založit změny. K získání objektu brány virtuální sítě můžete použít rutinu Get-AzureRmVirtualNetworkGateway.

Typ:PSVirtualNetworkGateway
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VpnClientAddressPool

Určuje adresní prostor, ze kterého tato rutina přiděluje IP adresy klienta VPN. To by se nemělo překrývat s virtuální sítí ani místními rozsahy.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VpnClientIpsecPolicy

Seznam zásad PROTOKOLU IPSec pro protokoly tunelování klientů P2S VPN

Typ:List<T>[PSIpsecPolicy]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VpnClientProtocol

Seznam protokolů tunelového propojení klientů P2S VPN

Typ:List<T>[String]
Přípustné hodnoty:SSTP, IkeV2, OpenVPN
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VpnClientRevokedCertificates

Určuje seznam odvolaných klientských certifikátů VPN. Klient VPN, který prezentuje certifikát, který odpovídá některému z těchto certifikátů, se odebere.

Typ:List<T>[PSVpnClientRevokedCertificate]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VpnClientRootCertificates

Určuje seznam kořenových certifikátů klienta VPN, které se mají použít pro ověřování klientů VPN. Připojení klienti VPN musí předložit certifikáty vygenerované z jednoho z těchto kořenových certifikátů.

Typ:List<T>[PSVpnClientRootCertificate]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSVirtualNetworkGateway

Parametry: 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

Výstupy

PSVirtualNetworkGateway

Poznámky

  • Klíčová slova: azure, azurerm, arm, resource, management, manager, network, networking