Configurare un gateway di rete virtuale per ExpressRoute usando PowerShell

Articolo
01/03/2024

Questo articolo illustra la procedura per aggiungere, ridimensionare e rimuovere un gateway di rete virtuale per una rete virtuale preesistente tramite PowerShell. I passaggi di questa configurazione si applicano alle reti virtuali create usando il modello di distribuzione di Resource Manager per una configurazione di ExpressRoute. Per altre informazioni sui gateway di rete virtuale e sulle impostazioni di configurazione dei gateway per ExpressRoute, vedere Informazioni sui gateway di rete virtuale per ExpressRoute.

Prerequisiti

Elenco di riferimento per la configurazione

Nei passaggi di questa attività viene usata una rete virtuale basata sui valori indicati nell'elenco di riferimento per la configurazione riportato di seguito. In questo elenco sono indicati anche i nomi e le impostazioni aggiuntive. Questo elenco non verrà utilizzato direttamente nella procedura, ma si aggiungeranno variabili basate sui valori nell'elenco. È possibile copiare l'elenco per usarlo come riferimento, sostituendo i valori con quelli personalizzati.

Impostazione	Valore
Nome rete virtuale	TestVNet
Spazio degli indirizzi della rete virtuale	192.168.0.0/16
Gruppo di risorse	TestRG
Nome della subnet1	FrontEnd
Spazio indirizzi della subnet1	192.168.1.0/24
Nome della subnet1	FrontEnd
Nome della subnet del gateway	GatewaySubnet
Spazio degli indirizzi della subnet del gateway	192.168.200.0/26
Area geografica	Stati Uniti orientali
Nome gateway	GW
Nome IP del gateway	GWIP
Nome della configurazione IP del gateway	gwipconf
Type	ExpressRoute
Nome IP pubblico del gateway	gwpip

Aggiungere un gateway

Importante

Se si prevede di usare il peering privato basato su IPv6 su ExpressRoute, assicurarsi di selezionare uno SKU AZ (ErGw1AZ, ErGw2AZ, ErGw3AZ) per -GatewaySku o usare sku non AZ (Standard, HighPerformance, UltraPerformance) per -GatewaySKU con IP pubblico standard e statico.

Per connettersi ad Azure, eseguire Connect-AzAccount.

Dichiarare le variabili per questa esercitazione. Assicurarsi di modificare l'esempio in base alle impostazioni da usare.

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

Archiviare l'oggetto rete virtuale come variabile.

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

Aggiungere una subnet gateway alla rete virtuale. La subnet gateway deve esistere già e deve essere denominata "GatewaySubnet". Il valore per la subnet del gateway deve essere /27 o superiore (/26, /25 e così via). Se si prevede di connettere 16 circuiti ExpressRoute al gateway, è necessario creare una subnet del gateway di /26 o superiore.
```
Add-AzVirtualNetworkSubnetConfig -Name GatewaySubnet -VirtualNetwork $vnet -AddressPrefix 192.168.200.0/26
```
Se si usa una rete virtuale dual stack e si prevede di usare il peering privato basato su IPv6 tramite ExpressRoute, creare invece una subnet del gateway dual stack.
```
Add-AzVirtualNetworkSubnetConfig -Name GatewaySubnet -VirtualNetwork $vnet -AddressPrefix "10.0.0.0/26","ace:daa:daaa:deaa::/64"
```

Impostare la configurazione.

$vnet = Set-AzVirtualNetwork -VirtualNetwork $vnet

Archiviare la subnet gateway come variabile.

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

Richiedere un indirizzo IP pubblico. L'indirizzo IP viene richiesto prima della creazione del gateway. Non è possibile specificare l'indirizzo IP da usare, perché viene assegnato dinamicamente. Questo indirizzo IP sarà utilizzato nella prossima sezione di configurazione. AllocationMethod deve essere Dynamic.
```
$pip = New-AzPublicIpAddress -Name $GWIPName  -ResourceGroupName $RG -Location $Location -AllocationMethod Static -SKU Standard
```
Nota

L'indirizzo IP pubblico dello SKU Basic non è supportato con il nuovo gateway di rete virtuale ExpressRoute.
Creare la configurazione per il gateway. La configurazione del gateway definisce la subnet e l'indirizzo IP pubblico da utilizzare. In questo passaggio si specifica la configurazione che verrà usata quando si crea il gateway. Per creare la configurazione del gateway, usare l'esempio seguente.
```
$ipconf = New-AzVirtualNetworkGatewayIpConfig -Name $GWIPconfName -Subnet $subnet -PublicIpAddress $pip
```
Creare il gateway. In questo passaggio -GatewayType è particolarmente importante. È necessario usare il valore ExpressRoute. Dopo aver eseguito questi cmdlet, la creazione del gateway può richiedere anche oltre 45 minuti.
```
New-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG -Location $Location -IpConfigurations $ipconf -GatewayType Expressroute -GatewaySku Standard
```

Verificare che il gateway sia stato creato

Per verificare che il gateway sia stato creato, usare i comandi seguenti:

Get-AzVirtualNetworkGateway -ResourceGroupName $RG

Ridimensionare un gateway

Esistono diversi SKU del gateway. È possibile usare il comando seguente per modificare la SKU del gateway in qualsiasi momento.

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

Pulire le risorse

Usare il comando seguente per rimuovere il gateway:

Remove-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG

Passaggi successivi

Dopo avere creato il gateway della rete virtuale, è possibile collegare la rete virtuale a un circuito ExpressRoute.

Collegare una rete virtuale a un circuito ExpressRoute

Condividi tramite