Condividi tramite

Convertire un peering diretto legacy in una risorsa di Azure usando PowerShell

  • Articolo

Questo articolo descrive come convertire un peering diretto legacy esistente in una risorsa di Azure usando i cmdlet di PowerShell.

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

Operazioni preliminari

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. https://shell.azure.com/powershell
Selezionare il pulsante Cloud Shell sulla barra degli strumenti in alto a destra del portale di Azure. Cloud Shell in the portal

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.

Convertire un peering diretto legacy in una risorsa di Azure

Accedere al proprio account Azure e selezionare la sottoscrizione

Prima di iniziare la configurazione, installare e importare i moduli necessari. Per installare i moduli in PowerShell sono necessari privilegi Amministrazione istrator.

  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 un peering diretto legacy per la conversione

Questo esempio illustra come ottenere un peering diretto legacy nella posizione di peering seattle.

$legacyPeering = Get-AzLegacyPeering `
    -Kind Direct -PeeringLocation "Seattle"
$legacyPeering

Di seguito è riportata una risposta di esempio:

Name                       :
Sku                        : Basic_Direct_Free
Kind                       : Direct
PeeringLocation            : Seattle
UseForPeeringService       : False
PeerAsn.Id                 :
Connection                 : ------------------------
PeeringDBFacilityId        : 71
SessionPrefixIPv4          : 4.71.156.72/30
PeerSessionIPv4Address     : 4.71.156.73
MicrosoftIPv4Address       : 4.71.156.74
SessionStateV4             : Established
MaxPrefixesAdvertisedV4    : 20000
SessionPrefixIPv6          : 2001:1900:2100::1e10/126
MaxPrefixesAdvertisedV6    : 2000
ConnectionState            : Active
BandwidthInMbps            : 0
ProvisionedBandwidthInMbps : 20000
Connection                 : ------------------------
PeeringDBFacilityId        : 71
SessionPrefixIPv4          : 4.68.70.140/30
PeerSessionIPv4Address     : 4.68.70.141
MicrosoftIPv4Address       : 4.68.70.142
SessionStateV4             : Established
MaxPrefixesAdvertisedV4    : 20000
SessionPrefixIPv6          : 2001:1900:4:3::cc/126
PeerSessionIPv6Address     : 2001:1900:4:3::cd
MicrosoftIPv6Address       : 2001:1900:4:3::ce
SessionStateV6             : Established
MaxPrefixesAdvertisedV6    : 2000
ConnectionState            : Active
BandwidthInMbps            : 0
ProvisionedBandwidthInMbps : 20000
ProvisioningState          : Succeeded

Convertire un peering diretto legacy

 

Importante

Quando si converte un peering legacy in una risorsa di Azure, le modifiche non sono supportate.  

Usare questo comando per convertire un peering diretto legacy in una risorsa di Azure:

$legacyPeering[0] | New-AzPeering `
    -Name "SeattleDirectPeering" `
    -ResourceGroupName "PeeringResourceGroup" `

Di seguito è riportata una risposta di esempio:

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

Risorse aggiuntive

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

Get-Help Get-AzPeering -detailed

Passaggi successivi