Creare o modificare un peering diretto con PowerShell

• Azure portal
• PowerShell

Questo articolo descrive come creare un peering Microsoft Direct usando i cmdlet di PowerShell e il modello di distribuzione di Azure Resource Manager. Questo articolo illustra anche come controllare lo stato della risorsa, aggiornarla o eliminarla ed eseguire il deprovisioning.

Se si preferisce, è possibile completare questa guida usando il portale di Azure.

Operazioni preliminari

• Prima di iniziare la configurazione, esaminare i prerequisiti e la procedura dettagliata per il peering diretto.
• Se si dispone già di connessioni peering dirette con Microsoft che non vengono convertite in risorse di Azure, vedere Convertire un peering diretto legacy in una risorsa di Azure usando PowerShell.

Usare Azure PowerShell

Per eseguire i cmdlet, è possibile usare Azure Cloud Shell, una shell interattiva gratuita. Include strumenti comuni di Azure preinstallati e configurati per l'uso con l'account. Selezionare Copia per copiare il codice e incollarlo in Cloud Shell. Selezionare quindi Invio per eseguirlo. Esistono alcuni modi per avviare Cloud Shell:

Launch, metodo	Schermata
Aprire Cloud Shell nel browser.
Selezionare il pulsante Cloud Shell sulla barra degli strumenti in alto a destra del portale di Azure.

Se non si vuole usare Azure Cloud Shell, è possibile installare PowerShell in locale. Se si sceglie di installare e usare PowerShell in locale, assicurarsi di installare la versione più recente dei cmdlet di PowerShell per Azure Resource Manager. I cmdlet di PowerShell vengono aggiornati di frequente. In genere è necessario aggiornare i cmdlet di PowerShell per ottenere la funzionalità più recente. In caso contrario, potrebbero verificarsi problemi.

Per trovare la versione di PowerShell in esecuzione in locale, usare il cmdlet 'Get-Module -ListAvailable Az' . Per aggiornare, vedere Installare il modulo Azure PowerShell. Per altre informazioni, vedere come installare e configurare Azure PowerShell.

Se si usa PowerShell in macOS, seguire la procedura descritta in Installazione di PowerShell in macOS.

Creare un peering di Direct ed effettuarne il provisioning

Accedere al proprio account Azure e selezionare la sottoscrizione

Prima di iniziare la configurazione, installare e importare i moduli necessari. Sono necessari privilegi di amministratore per installare i moduli in PowerShell.

1. Installare e importare il modulo Az.

   Install-Module Az -AllowClobber
   Import-Module Az
   

2. Installare e importare il modulo Az.Peering.

   Install-Module -Name Az.Peering -AllowClobber
   Import-Module Az.Peering
   

3. Verificare che i moduli importati correttamente usando questo comando:

   Get-Module
   

4. Accedere al proprio account di Azure con il seguente comando:

   Connect-AzAccount
   

5. Controllare le sottoscrizioni per l'account e selezionare la sottoscrizione in cui si vuole creare un peering.

   Get-AzSubscription
   Select-AzSubscription -SubscriptionId "subscription-id"
   

6. Se non si ha già un gruppo di risorse, è necessario crearne uno prima di creare un peering. A questo scopo, eseguire il comando seguente:

   New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"
   

Importante

Se l'ASN e la sottoscrizione non sono già state associate, seguire la procedura descritta in Associare l'ASN peer. Questa azione è necessaria per richiedere un peering.

Nota

La posizione di un gruppo di risorse è indipendente dalla posizione in cui si sceglie di configurare un peering.  

Ottenere l'elenco dei percorsi di peering supportati per il peering diretto

Il cmdlet di PowerShell Get-AzPeeringLocation restituisce un elenco di percorsi di peering con il parametro Kindobbligatorio , che verrà usato nei passaggi successivi.

Get-AzPeeringLocation -Kind Direct

Le posizioni di peering diretto contengono i campi seguenti:

• PeeringLocation
• Country
• PeeringDBFacilityId
• PeeringDBFacilityLink
• BandwidthOffers

Verificare di essere presenti nella struttura di peering desiderata facendo riferimento a PeeringDB.

Questo esempio illustra come usare Seattle come percorso di peering per creare un peering diretto.

$peeringLocations = Get-AzPeeringLocation -Kind Direct
$peeringLocation = $peeringLocations | where {$_.PeeringLocation -contains "Seattle"}
$peeringLocation

PeeringLocation       : Seattle
Address               : 2001 Sixth Avenue
Country               : US
PeeringDBFacilityId   : 71
PeeringDBFacilityLink : https://www.peeringdb.com/fac/71
BandwidthOffers       : {10Gbps, 100Gbps}

Creare un peering di Direct

L'esempio seguente illustra come creare un peering diretto da 10 Gbps a Seattle.

Usare il cmdlet di PowerShell New-AzPeeringDirectConnectionObject per creare oggetti DirectConnection da usare nella nuova richiesta di peering.

In questo esempio viene illustrato come creare un oggetto DirectConnection.

$connection1 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.31.0/31 `
    -SessionPrefixV6 fe01::3e:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

Nota

Il valore per $peeringLocation[] nell'esempio precedente deve corrispondere alla posizione di peering desiderata.

Creare un'altra connessione nel caso in cui sia necessaria la ridondanza in una determinata posizione di peering.

$connection2 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.33.0/31 `
    -SessionPrefixV6 fe01::3f:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

Usare il cmdlet di PowerShell New-AzPeering per creare un nuovo peering diretto. Questo comando richiede un ID risorsa ASN, che può essere recuperato come illustrato di seguito.

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleDirectPeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeeringLocation  $peeringLocation[0].PeeringLocation `
    -PeerAsnResourceId $asn.Id `
    -DirectConnection $connection1 [, $connection2]

 

Questo esempio mostra la risposta quando la richiesta è stata elaborata correttamente.

    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : 71
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

Si noti che al posto di {subscriptionId} in questo output verrà visualizzato l'ID sottoscrizione effettivo.

Verificare il peering di Direct

Per ottenere l'elenco dei peering, eseguire il comando Get-AzPeering .

$directPeering = Get-AzPeering -ResourceGroupName "PeeringResourceGroup" -Name "SeattleDirectPeering"

L'esempio seguente mostra la risposta al completamento del provisioning end-to-end.

    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : {71}
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

Modificare un peering di Direct

Questa sezione descrive come eseguire le operazioni di modifica seguenti per il peering diretto:

• Aggiungere connessioni di peering diretto.
• Rimuovere le connessioni peering dirette.
• Aggiornare o effettuare il downgrade della larghezza di banda nelle connessioni attive.
• Aggiungere sessioni IPv4 o IPv6 nelle connessioni attive.
• Rimuovere le sessioni IPv4 o IPv6 nelle connessioni attive.

Aggiungere connessioni peering dirette

Questo esempio descrive come aggiungere connessioni al peering diretto esistente.

$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"

$connection = New-AzPeeringDirectConnection `
    -PeeringDBFacilityId $peeringLocation.PeeringDBFacilityId `
    -SessionPrefixV4 "10.22.31.0/31" `
    -SessionPrefixV6 "fe02::3e:0/127" `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

$directPeering.Connections.Add($connection)

$directPeering | Update-AzPeering

Rimuovere connessioni peering dirette

La rimozione di una connessione non è attualmente supportata in PowerShell. Per altre informazioni, contattare il peering Microsoft.

Aggiornare o effettuare il downgrade della larghezza di banda nelle connessioni attive

Questo esempio descrive come aggiungere 10 Gbps a una connessione diretta esistente.

$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BandwidthInMbps  = 20000
$directPeering | Update-AzPeering

Aggiungere sessioni IPv4 o IPv6 nelle connessioni attive

Questo esempio descrive come aggiungere una sessione IPv6 in una connessione diretta esistente con solo una sessione IPv4.

$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BGPSession.SessionPrefixv6 = "fe01::3e:0/127"
$directPeering | Update-AzPeering

Rimuovere le sessioni IPv4 o IPv6 nelle connessioni attive

La rimozione di una sessione IPv4 o IPv6 da una connessione esistente non è attualmente supportata in PowerShell. Per altre informazioni, contattare il peering Microsoft.

Effettuare il deprovisioning di un peering di Direct

Attualmente, il deprovisioning non è supportato usando il portale di Azure o PowerShell. Per eseguire il deprovisioning, contattare il peering Microsoft.

Risorse aggiuntive

È possibile ottenere descrizioni dettagliate di tutti i parametri eseguendo il comando seguente:

Get-Help Get-AzPeering -detailed

Passaggi successivi

• Creare o modificare il peering di Exchange tramite PowerShell.
• Convertire un peering di Exchange legacy in una risorsa di Azure usando PowerShell.
• Domande frequenti sul peering Internet.