Delen via

Een directe peering maken of wijzigen met behulp van PowerShell

  • Artikel

In dit artikel wordt beschreven hoe u een Microsoft Direct-peering maakt met behulp van PowerShell-cmdlets en het Azure Resource Manager-implementatiemodel. In dit artikel leest u ook hoe u de status van de resource controleert, de resource bijwerkt of de inrichting ervan ongedaan maakt.

Als u wilt, kunt u deze handleiding voltooien met behulp van Azure Portal.

Voordat u begint

Werken met Azure PowerShell

Als u de cmdlets wilt uitvoeren, kunt u Azure Cloud Shell gebruiken, een gratis interactieve shell. In deze shell zijn algemene Azure-hulpprogramma's vooraf geïnstalleerd en geconfigureerd voor gebruik met uw account. Selecteer Kopiëren om de code te kopiëren en plak deze in Cloud Shell. Selecteer vervolgens Enter om het uit te voeren. Er zijn een aantal manieren om Cloud Shell te starten:

Startmethode Schermafbeelding
Open Cloud Shell in uw browser. https://shell.azure.com/powershell
Selecteer de knop Cloud Shell op de werkbalk in de rechterbovenhoek van Azure Portal. Cloud Shell in de portal

Als u Azure Cloud Shell niet wilt gebruiken, kunt u PowerShell lokaal installeren. Als u PowerShell lokaal wilt installeren en gebruiken, moet u de nieuwste versie van de Azure Resource Manager PowerShell-cmdlets installeren. PowerShell-cmdlets worden regelmatig bijgewerkt. Doorgaans moet u uw PowerShell-cmdlets bijwerken om de nieuwste functiefunctionaliteit te krijgen. Als u dat niet doet, kunnen er problemen optreden.

Gebruik de cmdlet Get-Module -ListAvailable Az om de versie van PowerShell te vinden die u lokaal uitvoert. Zie De Azure PowerShell-module installeren om bij te werken. Zie voor meer informatie hoe u Azure PowerShell installeert en configureert.

Als u PowerShell in macOS gebruikt, volgt u de stappen in Het installeren van PowerShell in macOS.

Een directe peering maken en inrichten

Aanmelden bij uw Azure-account en uw abonnement selecteren

Voordat u met de configuratie begint, moet u de vereiste modules installeren en importeren. U hebt beheerdersbevoegdheden nodig om modules te installeren in PowerShell.

  1. Installeer en importeer de Az-module.

    Install-Module Az -AllowClobber
Import-Module Az

  2. Installeer en importeer de Az.Peering-module.

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

  3. Controleer of de modules correct zijn geïmporteerd met behulp van deze opdracht:

    Get-Module

  4. Meld u aan bij uw Azure-account met behulp van deze opdracht:

    Connect-AzAccount

  5. Controleer de abonnementen voor het account en selecteer het abonnement waarin u een peering wilt maken.

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

  6. Als u nog geen resourcegroep hebt, moet u er een maken voordat u een peering maakt. U doet dit door de volgende opdracht uit te voeren:

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

Belangrijk

Als u uw ASN en abonnement nog niet hebt gekoppeld, volgt u de stappen in Peer ASN koppelen. Deze actie is vereist om een peering aan te vragen.

Notitie

De locatie van een resourcegroep is onafhankelijk van de locatie waar u een peering wilt instellen.  

De lijst met ondersteunde peeringlocaties voor directe peering ophalen

De PowerShell-cmdlet Get-AzPeeringLocation retourneert een lijst met peeringlocaties met de verplichte parameter Kind, die u in latere stappen gaat gebruiken.

Get-AzPeeringLocation -Kind Direct

Directe peeringlocaties bevatten de volgende velden:

  • PeeringLocation
  • Land/regio
  • PeeringDBFacilityId
  • PeeringDBFacilityLink
  • BandwidthOffers

Controleer of u aanwezig bent op de gewenste peeringfaciliteit door te verwijzen naar PeeringDB.

In dit voorbeeld ziet u hoe u Seattle gebruikt als peeringlocatie om een directe peering te maken.

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

Een directe peering maken

In het volgende voorbeeld ziet u hoe u een 10 Gbps Direct-peering maakt in Seattle.

Gebruik de PowerShell-cmdlet New-AzPeeringDirectConnectionObject om DirectConnection-objecten te maken die moeten worden gebruikt in de nieuwe peeringaanvraag.

In dit voorbeeld ziet u hoe u een DirectConnection-object maakt.

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

Notitie

De waarde voor $peeringLocation[] in het vorige voorbeeld moet overeenkomen met de peeringlocatie van uw keuze.

Maak een andere verbinding voor het geval u redundantie nodig hebt op een bepaalde peeringlocatie.

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

Gebruik de PowerShell-cmdlet New-AzPeering om een nieuwe Direct-peering te maken. Voor deze opdracht is een ASN-resource-id vereist. Deze kan worden opgehaald zoals hier wordt weergegeven.

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

 

In dit voorbeeld ziet u het antwoord wanneer de aanvraag is verwerkt.


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

Houd er rekening mee dat in plaats van {subscriptionId} in deze uitvoer de werkelijke abonnements-id wordt weergegeven.

Directe peering controleren

Voer de opdracht Get-AzPeering uit om de lijst met peerings op te halen.

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

In het volgende voorbeeld ziet u het antwoord wanneer end-to-end inrichting is voltooid.

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

Een directe peering wijzigen

In deze sectie wordt beschreven hoe u de volgende wijzigingsbewerkingen voor directe peering uitvoert:

  • Voeg directe peeringverbindingen toe.
  • Verwijder directe peeringverbindingen.
  • Upgrade- of downgradebandbreedte voor actieve verbindingen.
  • Voeg IPv4- of IPv6-sessies toe aan actieve verbindingen.
  • Verwijder IPv4- of IPv6-sessies voor actieve verbindingen.

Directe peeringverbindingen toevoegen

In dit voorbeeld wordt beschreven hoe u verbindingen toevoegt aan bestaande directe peering.


$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

Directe peeringverbindingen verwijderen

Het verwijderen van een verbinding wordt momenteel niet ondersteund in PowerShell. Neem contact op met Microsoft-peering voor meer informatie.

Bandbreedte upgraden of downgraden voor actieve verbindingen

In dit voorbeeld wordt beschreven hoe u 10 Gbps toevoegt aan een bestaande directe verbinding.


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

IPv4- of IPv6-sessies toevoegen aan actieve verbindingen

In dit voorbeeld wordt beschreven hoe u een IPv6-sessie toevoegt aan een bestaande directe verbinding met alleen een IPv4-sessie.


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

IPv4- of IPv6-sessies verwijderen voor actieve verbindingen

Het verwijderen van een IPv4- of IPv6-sessie vanuit een bestaande verbinding wordt momenteel niet ondersteund in PowerShell. Neem contact op met Microsoft-peering voor meer informatie.

De inrichting van een directe peering ongedaan maken

Op dit moment wordt het ongedaan maken van de inrichting niet ondersteund met behulp van Azure Portal of PowerShell. Neem contact op met Microsoft-peering om de inrichting ongedaan te maken.

Aanvullende bronnen

U kunt gedetailleerde beschrijvingen van alle parameters opvragen door de volgende opdracht uit te voeren:

Get-Help Get-AzPeering -detailed

Volgende stappen