Freigeben über

New-AzVpnGateway

Modul:
Az.Network Module

Erstellt ein skalierbares VPN-Gateway.

Syntax

ByVirtualHubName (Standard) 

New-AzVpnGateway
    -ResourceGroupName <String>
    -Name <String>
    -VpnGatewayScaleUnit <UInt32>
    -VirtualHubName <String>
    [-VpnConnection <PSVpnConnection[]>]
    [-EnableRoutingPreferenceInternetFlag]
    [-EnableBgpRouteTranslationForNat]
    [-VpnGatewayNatRule <PSVpnGatewayNatRule[]>]
    [-Tag <Hashtable>]
    [-Asn <UInt32>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualHubObject 

New-AzVpnGateway
    -ResourceGroupName <String>
    -Name <String>
    -VpnGatewayScaleUnit <UInt32>
    -VirtualHub <PSVirtualHub>
    [-VpnConnection <PSVpnConnection[]>]
    [-EnableRoutingPreferenceInternetFlag]
    [-EnableBgpRouteTranslationForNat]
    [-VpnGatewayNatRule <PSVpnGatewayNatRule[]>]
    [-Tag <Hashtable>]
    [-Asn <UInt32>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualHubResourceId 

New-AzVpnGateway
    -ResourceGroupName <String>
    -Name <String>
    -VpnGatewayScaleUnit <UInt32>
    -VirtualHubId <String>
    [-VpnConnection <PSVpnConnection[]>]
    [-EnableRoutingPreferenceInternetFlag]
    [-EnableBgpRouteTranslationForNat]
    [-VpnGatewayNatRule <PSVpnGatewayNatRule[]>]
    [-Tag <Hashtable>]
    [-Asn <UInt32>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

New-AzVpnGateway erstellt ein skalierbares VPN-Gateway. Dies ist softwaredefinierte Konnektivität für Standortverbindungen innerhalb von VirtualHub.

Dieses Gateway ändert die Größe und Skalierung basierend auf der Skalierungseinheit, die in diesem oder dem Cmdlet Set-AzVpnGateway angegeben ist.

Eine Verbindung wird von einer Verzweigung/einem Standort eingerichtet, der als VPNSite bezeichnet wird, zum skalierbaren Gateway. Jede Verbindung besteht aus 2 Active-Active Tunneln.

Das VpnGateway befindet sich an demselben Speicherort wie der referenzierte VirtualHub.

Beispiele

Beispiel 1

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
New-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -VirtualHubId $virtualHub.Id -VpnGatewayScaleUnit 2 -EnableRoutingPreferenceInternetFlag

ResourceGroupName   : testRG
Name                : testvpngw
Id                  : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/vpnGateways/testvpngw
Location            : West US
VpnGatewayScaleUnit : 2
VirtualHub          : /subscriptions/{subscriptionId}/resourceGroups/Ali_pS_Test/providers/Microsoft.Network/virtualHubs/westushub
BgpSettings         : {}
Type                : Microsoft.Network/vpnGateways
ProvisioningState   : Succeeded

Im obigen Beispiel wird eine Ressourcengruppe, virtual WAN, Virtual Network, Virtual Hub in West US in der Ressourcengruppe "testRG" in Azure erstellt. Anschließend wird im Virtuellen Hub ein VPN-Gateway mit 2 Skalierungseinheiten erstellt.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

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

-Asn

AsN des VPN-Gateways für BGP über VPN

Parametereigenschaften

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

Parametersätze

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

-Confirm

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
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

-EnableBgpRouteTranslationForNat

Flag zum Aktivieren der Bgp-Routenübersetzung für NAT auf diesem VpnGateway.

Parametereigenschaften

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

Parametersätze

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

-EnableRoutingPreferenceInternetFlag

Flag zum Aktivieren des Routingeinstellungs-Internets auf diesem VpnGateway.

Parametereigenschaften

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

Parametersätze

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

-Name

Der Ressourcenname.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Ressourcenname, VpnGatewayName

Parametersätze

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

-ResourceGroupName

Der Ressourcenname.

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

-Tag

Eine Hashtabelle, die Ressourcentags darstellt.

Parametereigenschaften

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

Parametersätze

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

-VirtualHub

Der VirtualHub muss diesem VpnGateway zugeordnet werden.

Parametereigenschaften

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

Parametersätze

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

-VirtualHubId

Die ID des VirtualHub dieses VpnGateway muss zugeordnet werden.

Parametereigenschaften

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

Parametersätze

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

-VirtualHubName

Die ID des VirtualHub dieses VpnGateway muss zugeordnet werden.

Parametereigenschaften

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

Parametersätze

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

-VpnConnection

Die Liste der VpnConnections, über die dieses VpnGateway verfügen muss.

Parametereigenschaften

Typ:

PSVpnConnection[]

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

Parametersätze

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

-VpnGatewayNatRule

Die Liste der VpnGatewayNatRules, die diesem VpnGateway zugeordnet sind.

Parametereigenschaften

Typ:

PSVpnGatewayNatRule[]

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

Parametersätze

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

-VpnGatewayScaleUnit

Die Skalierungseinheit für dieses VpnGateway.

Parametereigenschaften

Typ:UInt32
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

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
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

PSVirtualHub

String

Ausgaben

PSVpnGateway