Dela via

Konvertera en äldre direktpeering till en Azure-resurs med hjälp av PowerShell

  • Artikel

Den här artikeln beskriver hur du konverterar en befintlig äldre direktpeering till en Azure-resurs med hjälp av PowerShell-cmdletar.

Om du vill kan du slutföra den här guiden med hjälp av Azure-portalen.

Innan du börjar

Arbeta med Azure PowerShell

Om du vill köra cmdletarna kan du använda Azure Cloud Shell, ett kostnadsfritt interaktivt gränssnitt. Den har vanliga Azure-verktyg förinstallerat och har konfigurerats för användning med ditt konto. Välj Kopiera för att kopiera koden och klistra in den i Cloud Shell. Välj sedan Retur för att köra det. Det finns några sätt att starta Cloud Shell:

Startmetod Skärmbild
Öppna Cloud Shell i din webbläsare. https://shell.azure.com/powershell
Välj knappen Cloud Shell i verktygsfältet längst upp till höger i Azure-portalen. Cloud Shell in the portal

Om du inte vill använda Azure Cloud Shell kan du installera PowerShell lokalt i stället. Om du väljer att installera och använda PowerShell lokalt måste du installera den senaste versionen av Azure Resource Manager PowerShell-cmdletarna. PowerShell-cmdletar uppdateras ofta. Du behöver vanligtvis uppdatera dina PowerShell-cmdletar för att få de senaste funktionsfunktionerna. Om du inte gör det kan det uppstå problem.

Om du vill hitta den version av PowerShell som du kör lokalt använder du cmdleten "Get-Module -ListAvailable Az" . Information om hur du uppdaterar finns i Installera Azure PowerShell-modulen. Mer information finns i installera och konfigurera Azure PowerShell.

Om du använder PowerShell på macOS följer du stegen i Installera PowerShell på macOS.

Konvertera en äldre direktpeering till en Azure-resurs

Logga in på ditt Azure-konto och välj din prenumeration

Innan du påbörjar konfigurationen installerar och importerar du de moduler som krävs. Du behöver administratörsbehörighet för att installera moduler i PowerShell.

  1. Installera och importera Az-modulen.

    Install-Module Az -AllowClobber
Import-Module Az

  2. Installera och importera Az.Peering-modulen.

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

  3. Kontrollera att modulerna har importerats korrekt med hjälp av det här kommandot:

    Get-Module

  4. Logga in på ditt Azure-konto med det här kommandot:

    Connect-AzAccount

  5. Kontrollera prenumerationerna för kontot och välj den prenumeration där du vill skapa en peering.

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

  6. Om du inte redan har en resursgrupp måste du skapa en innan du skapar en peering. Du kan göra det genom att köra följande kommando:

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

Viktigt!

Om du inte redan har associerat ditt ASN och din prenumeration följer du stegen i Associera peer-ASN. Den här åtgärden krävs för att begära en peering.

Kommentar

Platsen för en resursgrupp är oberoende av den plats där du väljer att konfigurera en peering.  

Hämta en äldre direktpeering för konvertering

Det här exemplet visar hur du hämtar en äldre direktpeering på seattle-peeringplatsen.

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

Här är ett exempel:

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

Konvertera en äldre direktpeering

 

Viktigt!

När du konverterar en äldre peering till en Azure-resurs stöds inte ändringar.  

Använd det här kommandot för att konvertera en äldre direktpeering till en Azure-resurs:

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

Här är ett exempel:

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                 : {}

Ytterligare resurser

Du kan få detaljerade beskrivningar av alla parametrar genom att köra det här kommandot:

Get-Help Get-AzPeering -detailed

Nästa steg