Konfigurieren eines Gateways für ein virtuelles Netzwerk für ExpressRoute mit PowerShell

In diesem Artikel finden Sie die Schritte zum Hinzufügen, Ändern der Größe und Entfernen eines VNet-Gateways für ein vorhandenes virtuelles Netzwerk (VNet) über PowerShell. Die Schritte für diese Konfiguration gelten für VNETs, die mit dem Resource Manager-Bereitstellungsmodell für eine ExpressRoute-Konfiguration erstellt wurden. Weitere Informationen zu virtuellen Netzwerkgateways und Gateway-Konfigurationseinstellungen für ExpressRoute finden Sie unter Informationen zu Gateways für virtuelle Netzwerke für ExpressRoute.

Voraussetzungen

Referenzliste für Konfiguration

Bei den Schritten für diese Aufgabe wird ein VNet basierend auf den Werten verwendet, die in der folgenden Referenzliste für die Konfiguration enthalten sind. Zusätzliche Einstellungen und Namen werden ebenfalls in dieser Liste beschrieben. Wir verwenden diese Liste nicht direkt in einem der Schritte, obwohl wir Variablen basierend auf den Werten in dieser Liste hinzufügen. Sie können diese Liste als Referenz verwenden und die Werte durch Ihre eigenen Werte ersetzen.

Hinzufügen eines Gateways

1. Führen Sie Connect-AzAccount aus, um eine Verbindung mit Azure herzustellen.

2. Deklarieren Sie Ihre Variablen für dieses Tutorial. Achten Sie darauf, das Beispiel so zu bearbeiten, dass es den gewünschten Einstellungen entspricht.

   $RG = "TestRG"
   $Location = "West US"
   $GWName = "GW"
   $GWIPName = "GWIP"
   $GWIPconfName = "gwipconf"
   $VNetName = "TestVNet"
   

   Wenn Sie das Gateway in einer erweiterten Azure-Zone erstellen möchten, fügen Sie die Variable $ExtendedLocation hinzu.

   $RG = "TestRG"
   $Location = "West US"
   $ExtendedLocation = "losangeles"
   $GWName = "GW"
   $GWIPName = "GWIP"
   $GWIPconfName = "gwipconf"
   $VNetName = "TestVNet"
   

3. Speichern Sie das virtuelle Netzwerkobjekt als Variable.

   $vnet = Get-AzVirtualNetwork -Name $VNetName -ResourceGroupName $RG
   

4. Fügen Sie Ihrem virtuellen Netzwerk ein Gatewaysubnetz hinzu. Das Gatewaysubnetz muss den Namen GatewaySubnet tragen. Das Gatewaysubnetz muss /27 oder größer sein (/26, /25 usw.). Wenn Sie 16 ExpressRoute-Leitungen mit Ihrem Gateway verbinden möchten, müssen Sie ein Gatewaysubnetz mit einer Größe von mindestens /26 erstellen.

   Add-AzVirtualNetworkSubnetConfig -Name GatewaySubnet -VirtualNetwork $vnet -AddressPrefix 192.168.200.0/26
   

   Wenn Sie ein virtuelles Dual-Stack-Netzwerk verwenden und beabsichtigen, IPv6-basiertes privates Peering über ExpressRoute einzusetzen, sollten Sie stattdessen ein Dual-Stack-Gatewaysubnetz erstellen.

   Add-AzVirtualNetworkSubnetConfig -Name GatewaySubnet -VirtualNetwork $vnet -AddressPrefix "10.0.0.0/26","ace:daa:daaa:deaa::/64"
   

5. Legen Sie die Konfiguration fest.

   $vnet = Set-AzVirtualNetwork -VirtualNetwork $vnet
   

6. Speichern Sie das Gatewaysubnetz als Variable.

   $subnet = Get-AzVirtualNetworkSubnetConfig -Name 'GatewaySubnet' -VirtualNetwork $vnet
   

7. Fordern Sie eine öffentliche IP-Adresse an. Die IP-Adresse wird angefordert, bevor das Gateway erstellt wird. Sie können die IP-Adresse, die Sie verwenden möchten, nicht selbst angeben. Sie wird dynamisch zugewiesen. Diese IP-Adresse wird im nächsten Konfigurationsabschnitt verwendet. Die AllocationMethod muss dynamisch sein.

   $pip = New-AzPublicIpAddress -Name $GWIPName  -ResourceGroupName $RG -Location $Location -AllocationMethod Static -SKU Standard
   

   Wenn Sie das Gateway in einer erweiterten Azure-Zone erstellen möchten, fordern Sie mithilfe des -ExtendedLocation-Parameters eine öffentliche IP-Adresse in der erweiterten Zone an.

   $pip = New-AzPublicIpAddress -Name $GWIPName  -ResourceGroupName $RG -Location $Location -ExtendedLocation $ExtendedLocation -AllocationMethod Static -SKU Standard
   

   Hinweis

   Die öffentliche IP-Adresse der Basic-SKU wird mit dem neuen virtuellen ExpressRoute-Netzwerkgateway nicht unterstützt.

8. Erstellen Sie die Konfiguration für Ihr Gateway. Die Gatewaykonfiguration definiert das zu verwendende Subnetz und die zu verwendende öffentliche IP-Adresse. In diesem Schritt geben Sie die Konfiguration an, die beim Erstellen des Gateways verwendet wird. Verwenden Sie das folgende Beispiel, um Ihre Gatewaykonfiguration zu erstellen.

   $ipconf = New-AzVirtualNetworkGatewayIpConfig -Name $GWIPconfName -Subnet $subnet -PublicIpAddress $pip
   

9. Erstellen Sie das Gateway. In diesem Schritt ist -GatewayType besonders wichtig. Sie müssen den Wert ExpressRouteverwenden. Das Erstellen des Gateways kann nach der Ausführung dieser Cmdlets 45 Minuten oder länger dauern.

   New-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG -Location $Location -IpConfigurations $ipconf -GatewayType Expressroute -GatewaySku Standard
   

   Wenn Sie das Gateway in einer erweiterten Azure-Zone erstellen möchten, fügen Sie den -ExtendedLocation-Parameter hinzu.

   New-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG -Location $Location -ExtendedLocation $ExtendedLocation -IpConfigurations $ipconf -GatewayType Expressroute -GatewaySku Standard
   

   Hinweis

   Um das Gateway in einer erweiterten Azure-Zone zu erstellen, müssen Sie zunächst Zugriff auf die erweiterte Zone anfordern. Wenn Sie Zugriff haben, können Sie das Gateway erstellen.

   Die folgenden Überlegungen gelten beim Erstellen eines Virtual Network-Gateways in einer erweiterten Zone:

   • Verfügbarkeitszonen werden in erweiterten Azure-Zonen nicht unterstützt.
   • Die folgenden SKUs werden derzeit in erweiterten Azure-Zonen unterstützt: Standard, HighPerformance, UltraPerformance.
   • Eine lokale SKU-Leitung wird für Gateways in erweiterten Azure-Zonen nicht unterstützt.

Erstellung des Gateways überprüfen

Verwenden Sie die folgenden Befehle, um zu überprüfen, ob das Gateway erstellt wurde:

Get-AzVirtualNetworkGateway -ResourceGroupName $RG

Ändern der Größe eines Gateways

Es gibt eine Reihe von Gateway-SKUs. Sie können jederzeit den folgenden Befehl verwenden, um die Gateway-SKU zu ändern.

$gw = Get-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG
Resize-AzVirtualNetworkGateway -VirtualNetworkGateway $gw -GatewaySku HighPerformance

Bereinigen von Ressourcen

Verwenden Sie den folgenden Befehl zum Entfernen des Gateways:

Remove-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG

Nächste Schritte

Nachdem Sie das VNET-Gateway erstellt haben, können Sie Ihr VNET mit einer ExpressRoute-Leitung verknüpfen.