Configurare un gateway di rete virtuale per ExpressRoute usando PowerShell

  • Articolo

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.

Diagram showing an ExpressRoute gateway connected to the ExpressRoute circuit.

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.

  1. Per connettersi ad Azure, eseguire Connect-AzAccount.

  2. 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"

  3. Archiviare l'oggetto rete virtuale come variabile.

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

  4. 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"

  5. Impostare la configurazione.

    $vnet = Set-AzVirtualNetwork -VirtualNetwork $vnet

  6. Archiviare la subnet gateway come variabile.

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

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

  8. 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

  9. 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