Konfigurera en virtuell nätverksgateway för ExpressRoute med PowerShell

Artikel
01/03/2024

Den här artikeln beskriver stegen för att lägga till, ändra storlek på och ta bort en virtuell nätverksgateway för ett befintligt virtuellt nätverk (VNet) med hjälp av PowerShell. Stegen för den här konfigurationen gäller för virtuella nätverk som skapades med hjälp av Resource Manager distributionsmodell för en ExpressRoute-konfiguration. Mer information om virtuella nätverksgatewayer och konfigurationsinställningar för gatewayer för ExpressRoute finns i Om virtuella nätverksgatewayer för ExpressRoute.

Diagram showing an ExpressRoute gateway connected to the ExpressRoute circuit.

Förutsättningar

Konfigurationsreferenslista

Stegen för den här uppgiften använder ett virtuellt nätverk baserat på värdena i följande konfigurationsreferenslista. Ytterligare inställningar och namn beskrivs också i den här listan. Vi använder inte den här listan direkt i något av stegen, även om vi lägger till variabler baserat på värdena i den här listan. Du kan kopiera listan som ska användas som referens och ersätta värdena med dina egna.

Inställning	Värde
Namn på virtuellt nätverk	TestVNet
Adressutrymme för virtuellt nätverk	192.168.0.0/16
Resursgrupp	TestRG
Namn på undernät1	Frontend
Adressutrymme för undernät1	192.168.1.0/24
Namn på undernät1	Frontend
Gateway-undernätsnamn	GatewaySubnet
Adressutrymme för gatewayundernät	192.168.200.0/26
Region	USA, östra
Gatewaynamn	GW
Gateway-IP-namn	GWIP
Namn på gateway-IP-konfiguration	gwipconf
Typ	ExpressRoute
Offentligt IP-namn för gateway	gwpip

Lägga till en gateway

Viktigt!

Om du planerar att använda IPv6-baserad privat peering via ExpressRoute ska du välja en AZ SKU (ErGw1AZ, ErGw2AZ, ErGw3AZ) för -GatewaySku eller använda Icke-AZ SKU (Standard, HighPerformance, UltraPerformance) för -GatewaySKU med standard- och statisk offentlig IP-adress.

Om du vill ansluta till Azure kör du Connect-AzAccount.
Deklarera dina variabler för den här självstudien. Se till att redigera exemplet så att det återspeglar de inställningar som du vill använda.
```
$RG = "TestRG"
$Location = "East US"
$GWName = "GW"
$GWIPName = "GWIP"
$GWIPconfName = "gwipconf"
$VNetName = "TestVNet"
```

Lagra det virtuella nätverksobjektet som en variabel.

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

Lägg till ett gateway-undernät i ditt virtuella nätverk. Gateway-undernätet måste ha namnet "GatewaySubnet". Gateway-undernätet måste vara /27 eller större (/26, /25 och så vidare). Om du planerar att ansluta 16 ExpressRoute-kretsar till din gateway måste du skapa ett gateway-undernät på /26 eller större.
```
Add-AzVirtualNetworkSubnetConfig -Name GatewaySubnet -VirtualNetwork $vnet -AddressPrefix 192.168.200.0/26
```
Om du använder ett virtuellt nätverk med dubbla staplar och planerar att använda IPv6-baserad privat peering via ExpressRoute skapar du i stället ett gateway-undernät med dubbla staplar.
```
Add-AzVirtualNetworkSubnetConfig -Name GatewaySubnet -VirtualNetwork $vnet -AddressPrefix "10.0.0.0/26","ace:daa:daaa:deaa::/64"
```

Ange konfigurationen.

$vnet = Set-AzVirtualNetwork -VirtualNetwork $vnet

Lagra gatewayundernätet som en variabel.

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

Begär en offentlig IP-adress. IP-adressen begärs innan du skapar gatewayen. Du kan inte ange den IP-adress som du vill använda. den är dynamiskt tilldelad. I nästa konfigurationsavsnitt ska du använda denna IP-adress. AllocationMethod måste vara dynamisk.
```
$pip = New-AzPublicIpAddress -Name $GWIPName  -ResourceGroupName $RG -Location $Location -AllocationMethod Static -SKU Standard
```
Kommentar

Grundläggande offentlig IP-adress för SKU stöds inte med den nya virtuella ExpressRoute-nätverksgatewayen.
Skapa konfigurationen för din gateway. Gateway-konfigurationen definierar undernätet och den offentliga IP-adress som ska användas. I det här steget anger du den konfiguration som ska användas när du skapar gatewayen. Använd följande exempel för att skapa din gateway-konfiguration.
```
$ipconf = New-AzVirtualNetworkGatewayIpConfig -Name $GWIPconfName -Subnet $subnet -PublicIpAddress $pip
```
Skapa gatewayen. I det här steget är -GatewayType särskilt viktigt. Du måste använda värdet ExpressRoute. När du har kört dessa cmdletar kan det ta 45 minuter eller mer att skapa gatewayen.
```
New-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG -Location $Location -IpConfigurations $ipconf -GatewayType Expressroute -GatewaySku Standard
```

Kontrollera att gatewayen har skapats

Använd följande kommandon för att kontrollera att gatewayen har skapats:

Get-AzVirtualNetworkGateway -ResourceGroupName $RG

Ändra storlek på en gateway

Det finns ett antal gateway-SKU:er. Du kan använda följande kommando för att ändra gateway-SKU:n när som helst.

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

Rensa resurser

Använd följande kommando för att ta bort gatewayen:

Remove-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG

Nästa steg

När du har skapat den virtuella nätverksgatewayen kan du länka ditt virtuella nätverk till en ExpressRoute-krets.

Länka ett virtuellt nätverk till en ExpressRoute-krets