Udostępnij za pośrednictwem

Set-AzureRmVirtualNetworkGateway

  • Odwołanie
Moduł:
AzureRM.Network

Aktualizacje bramy sieci wirtualnej.

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet Set-AzureRmVirtualNetworkGateway aktualizuje bramę sieci wirtualnej.

Przykłady

Przykład 1. Ustawianie stanu celu bramy sieci wirtualnej

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

Pierwsze polecenie pobiera bramę sieci wirtualnej o nazwie Gateway01 należącą do grupy zasobów ResourceGroup001 i zapisuje ją w zmiennej o nazwie $Gateway Drugie polecenie ustawia stan celu bramy sieci wirtualnej przechowywanej w zmiennej $Gateway. Polecenie ustawia również nazwę ASN na 1337.

Przykład 2. Ustawianie stanu celu bramy sieci wirtualnej

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

Pierwsze polecenie pobiera bramę sieci wirtualnej o nazwie Gateway01, która należy do grupy zasobów ResourceGroup001 i zapisuje ją w zmiennej o nazwie $Gateway Drugie polecenie tworzy obiekt zasad ipsec sieci Vpn zgodnie z określonymi parametrami ipsec. Trzecie polecenie ustawia stan celu bramy sieci wirtualnej przechowywanej w zmiennej $Gateway. Polecenie ustawia również niestandardowe zasady ipsec sieci VPN określone w obiekcie $vpnclientipsecpolicy w bramie sieci wirtualnej.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Asn

Określa bramę sieci wirtualnej Autonomiczny numer systemu (ASN), który jest używany do konfigurowania sesji protokołu BGP (Border Gateway Protocol) wewnątrz tuneli IPsec.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisableActiveActiveFeature

Wyłącza funkcję aktywne-aktywne.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EnableActiveActiveFeature

Włącza funkcję aktywny-aktywny.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-GatewayDefaultSite

Określa domyślną lokację, która ma być używana do tunelowania wymuszonego. Jeśli zostanie określona lokacja domyślna, cały ruch internetowy z wirtualnej sieci prywatnej bramy (VPN) jest kierowany do tej lokacji.

Typ:PSLocalNetworkGateway
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-GatewaySku

Określa jednostkę przechowywania zapasów (SKU) bramy sieci wirtualnej. Dopuszczalne wartości tego parametru to:

  • Podstawowa
  • Standardowa (Standard)
  • Wysoka wydajność (HighPerformance)
  • VpnGw1
  • VpnGw2
  • VpnGw3
  • VpnGw1AZ
  • VpnGw2AZ
  • VpnGw3AZ
  • ErGw1AZ
  • ErGw2AZ
  • ErGw3AZ
Typ:String
Dopuszczalne wartości:Basic, Standard, HighPerformance, UltraPerformance, VpnGw1, VpnGw2, VpnGw3, VpnGw1AZ, VpnGw2AZ, VpnGw3AZ, ErGw1AZ, ErGw2AZ, ErGw3AZ
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PeerWeight

Określa wagę dodaną do tras poznanych za pośrednictwem protokołu BGP z tej bramy sieci wirtualnej

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RadiusServerAddress

Zewnętrzny adres serwera radius typu punkt-lokacja.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RadiusServerSecret

Wpis tajny serwera usługi Radius zewnętrznego typu punkt-lokacja.

Typ:SecureString
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VirtualNetworkGateway

Określa obiekt bramy sieci wirtualnej, aby oprzeć modyfikacje poza. Aby uzyskać obiekt bramy sieci wirtualnej, możesz użyć polecenia cmdlet Get-AzureRmVirtualNetworkGateway.

Typ:PSVirtualNetworkGateway
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VpnClientAddressPool

Określa przestrzeń adresową używaną przez to polecenie cmdlet do przydzielenia adresów IP klienta sieci VPN. Nie powinno się to nakładać na sieć wirtualną ani zakresy lokalne.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VpnClientIpsecPolicy

Lista zasad protokołu IPSec dla protokołów tunelowania klienta sieci VPN typu punkt-lokacja.

Typ:List<T>[PSIpsecPolicy]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VpnClientProtocol

Lista protokołów tunelowania klienta sieci VPN typu punkt-lokacja

Typ:List<T>[String]
Dopuszczalne wartości:SSTP, IkeV2, OpenVPN
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VpnClientRevokedCertificates

Określa listę odwołanych certyfikatów klienta sieci VPN. Klient sieci VPN przedstawiający certyfikat zgodny z jednym z tych elementów jest usuwany.

Typ:List<T>[PSVpnClientRevokedCertificate]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VpnClientRootCertificates

Określa listę certyfikatów głównych klienta sieci VPN do użycia na potrzeby uwierzytelniania klienta sieci VPN. Połączenie klientów sieci VPN muszą prezentować certyfikaty wygenerowane na podstawie jednego z tych certyfikatów głównych.

Typ:List<T>[PSVpnClientRootCertificate]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

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

Dane wyjściowe

PSVirtualNetworkGateway

Uwagi

  • Słowa kluczowe: azure, azurerm, arm, resource, management, manager, network, networking