Dela via

Skapa eller ändra en direktpeering med PowerShell

  • Artikel

Den här artikeln beskriver hur du skapar en Microsoft Direct-peering med hjälp av PowerShell-cmdletar och Azure Resource Manager-distributionsmodellen. Den här artikeln visar också hur du kontrollerar resursens status, uppdaterar den eller tar bort och avetabler den.

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

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 cloud shell-knappen i verktygsfältet längst upp till höger i Azure Portal. Cloud Shell på portalen

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.

Skapa och etablera en direkt peering

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 listan över peeringplatser som stöds för direkt peering

PowerShell-cmdleten Get-AzPeeringLocation returnerar en lista över peeringplatser med den obligatoriska parametern Kind, som du ska använda i senare steg.

Get-AzPeeringLocation -Kind Direct

Direkta peeringplatser innehåller följande fält:

  • PeeringLocation
  • Land
  • PeeringDBFacilityId
  • PeeringDBFacilityLink
  • BandwidthOffers

Kontrollera att du är närvarande vid önskad peering-anläggning genom att referera till PeeringDB.

Det här exemplet visar hur du använder Seattle som peeringplats för att skapa en direkt peering.

$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}

Skapa en direkt peering

I följande exempel visas hur du skapar en 10 Gbit/s direct-peering i Seattle.

Använd PowerShell-cmdleten New-AzPeeringDirectConnectionObject för att skapa DirectConnection-objekt som ska användas i den nya peering-begäran.

Det här exemplet visar hur du skapar ett DirectConnection-objekt.

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

Kommentar

Värdet för $peeringLocation[] i föregående exempel ska motsvara valfri peeringplats.

Skapa en annan anslutning om du behöver redundans på en viss peeringplats.

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

Använd PowerShell-cmdleten New-AzPeering för att skapa en ny direktpeering. Det här kommandot kräver ett ASN-resurs-ID som kan hämtas som det visas här.

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

 

Det här exemplet visar svaret när begäran har bearbetats.


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

Observera att i stället för {subscriptionId} i den här utdatan visas det faktiska prenumerations-ID:t.

Verifiera direkt peering

Hämta listan över peerings genom att köra kommandot Get-AzPeering .

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

I följande exempel visas svaret när etableringen från slutpunkt till slutpunkt slutfördes.

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

Ändra en direkt peering

I det här avsnittet beskrivs hur du utför följande ändringsåtgärder för direkt peering:

  • Lägg till direct peering-anslutningar.
  • Ta bort direkta peeringanslutningar.
  • Uppgradera eller nedgradera bandbredden för aktiva anslutningar.
  • Lägg till IPv4- eller IPv6-sessioner på aktiva anslutningar.
  • Ta bort IPv4- eller IPv6-sessioner på aktiva anslutningar.

Lägga till direct peering-anslutningar

I det här exemplet beskrivs hur du lägger till anslutningar till befintlig direktpeering.


$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

Ta bort direkta peeringanslutningar

Det går för närvarande inte att ta bort en anslutning i PowerShell. Kontakta Microsoft-peering om du vill ha mer information.

Uppgradera eller nedgradera bandbredd på aktiva anslutningar

I det här exemplet beskrivs hur du lägger till 10 Gbit/s till en befintlig direktanslutning.


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

Lägga till IPv4- eller IPv6-sessioner på aktiva anslutningar

I det här exemplet beskrivs hur du lägger till en IPv6-session på en befintlig direktanslutning med endast en IPv4-session.


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

Ta bort IPv4- eller IPv6-sessioner på aktiva anslutningar

Det går för närvarande inte att ta bort en IPv4- eller IPv6-session från en befintlig anslutning i PowerShell. Kontakta Microsoft-peering om du vill ha mer information.

Avetablera en direktpeering

För närvarande stöds inte avetablering med hjälp av Azure Portal eller PowerShell. Kontakta Microsoft-peering om du vill avetablera.

Ytterligare resurser

Du kan få detaljerade beskrivningar av alla parametrar genom att köra följande kommando:

Get-Help Get-AzPeering -detailed

Nästa steg