Erstellen oder Ändern einer Instanz für Direct Peering mit PowerShell

  • Artikel

In diesem Artikel wird beschrieben, wie Sie mit PowerShell-Cmdlets und dem Azure Resource Manager-Bereitstellungsmodell ein direktes Peering mit Microsoft erstellen. Der Artikel veranschaulicht auch, wie Sie den Status der Ressource prüfen und die Ressource aktualisieren, löschen oder ihre Bereitstellung aufheben.

Sie können diese Anleitung auch im Azure-Portal durchführen, wenn Sie das vorziehen.

Voraussetzungen

Arbeiten mit Azure PowerShell

Um die Cmdlets auszuführen, können Sie Azure Cloud Shell verwenden, eine kostenlose interaktive Shell. Sie verfügt über allgemeine vorinstallierte Tools und ist für die Verwendung mit Ihrem Konto konfiguriert. Wählen Sie Kopieren aus, um den Code zu kopieren, und fügen Sie ihn in Cloud Shell ein. Drücken Sie dann die EINGABETASTE, um ihn auszuführen. Cloud Shell kann auf mehrere Arten gestartet werden:

Startmethode Screenshot
Öffnen Sie Cloud Shell in Ihrem Browser. https://shell.azure.com/powershell
Wählen Sie die Schaltfläche Cloud Shell auf der Symbolleiste rechts oben im Azure-Portal aus. Cloud Shell im Portal

Wenn Sie Azure Cloud Shell nicht verwenden möchten, können Sie PowerShell lokal installieren. Wenn Sie PowerShell lokal installieren und verwenden möchten, müssen Sie die aktuelle Version der PowerShell-Cmdlets für Azure Resource Manager installieren. PowerShell-Cmdlets werden regelmäßig aktualisiert. Sie müssen Ihre PowerShell-Cmdlets in der Regel aktualisieren, um die neuesten Features und Funktionen nutzen zu können. Andernfalls treten möglicherweise Probleme auf.

Um die Version von PowerShell zu ermitteln, die Sie lokal ausführen, verwenden Sie das Cmdlet Get-Module -ListAvailable Az. Informationen zum Aktualisieren finden Sie unter Installieren des Azure PowerShell-Moduls. Weitere Informationen finden Sie unter Installieren und Konfigurieren von Azure PowerShell.

Wenn Sie PowerShell unter macOS verwenden, befolgen Sie die Schritte unter Installieren von PowerShell unter macOS.

Erstellen und Bereitstellen eines direkten Peerings

Melden Sie sich bei Ihrem Azure-Konto an, und wählen Sie Ihr Abonnement aus.

Bevor Sie mit der Konfiguration beginnen, installieren und importieren Sie die erforderlichen Module. Zum Installieren der Module in PowerShell benötigen Sie Administratorberechtigungen.

  1. Installieren und importieren Sie das Az-Modul.

    Install-Module Az -AllowClobber
Import-Module Az

  2. Installieren und importieren Sie das Az.Peering-Modul.

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

  3. Überprüfen Sie mithilfe des folgenden Befehls, ob die Module ordnungsgemäß importiert wurden:

    Get-Module

  4. Melden Sie sich mit diesem Befehl bei Ihrem Azure-Konto an:

    Connect-AzAccount

  5. Sehen Sie sich die Abonnements für das Konto an, und wählen Sie das Abonnement aus, in dem Sie ein Peering erstellen möchten.

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

  6. Wenn Sie noch keine Ressourcengruppe besitzen, müssen Sie zuerst eine erstellen, bevor Sie ein Peering erstellen. Dazu können Sie den folgenden Befehl ausführen:

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

Wichtig

Wenn Sie Ihre ASN und Ihr Abonnement noch nicht zugeordnet haben, führen Sie die Schritte zum Zuordnen einer Peer-ASN aus. Diese Aktion ist erforderlich, um ein Peering anzufordern.

Hinweis

Der Speicherort einer Ressourcengruppe ist unabhängig vom Speicherort, an dem Sie ein Peering einrichten möchten.  

Abrufen der Liste mit unterstützten Peeringstandorten für direktes Peering

Das PowerShell-Cmdlet Get-AzPeeringLocation gibt mit dem obligatorischen Parameter Kind eine Liste der Peeringstandorte zurück, die Sie in späteren Schritten verwenden.

Get-AzPeeringLocation -Kind Direct

Direct Peering-Standorte enthalten die folgenden Felder:

  • PeeringLocation
  • Land / Region
  • PeeringDBFacilityId
  • PeeringDBFacilityLink
  • BandwidthOffers

Überprüfen Sie anhand der PeeringDB, ob Sie in der gewünschten Peeringeinrichtung vorhanden sind.

In diesem Beispiel wird gezeigt, wie Sie Seattle als Peeringstandort zum Erstellen eines Direct-Peerings verwenden.

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

Erstellen eines direkten Peerings

Im folgenden Beispiel wird gezeigt, wie Sie ein Direct-Peering mit 10 GBit/s in Seattle erstellen.

Verwenden Sie das PowerShell-Cmdlet New-AzPeeringDirectConnectionObject, um DirectConnection-Objekte zu erstellen, die in der neuen Peeringanforderung verwendet werden sollen.

In diesem Beispiel wird die Erstellung eines DirectConnection-Objekts gezeigt.

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

Hinweis

Der Wert für $peeringLocation[] im obigen Beispiel sollte dem gewünschten Peeringstandort entsprechen.

Erstellen Sie eine weitere Verbindung, falls Redundanz an einem bestimmten Peeringstandort erforderlich ist.

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

Verwenden Sie das PowerShell-Cmdlet New-AzPeering, um eine neue Direct-Peeringverbindung zu erstellen. Für diesen Befehl ist eine ASN-Ressourcen-ID erforderlich, die wie hier gezeigt abgerufen werden kann.

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

 

Dieses Beispiel zeigt die Antwort für den Fall, dass die Anforderung erfolgreich verarbeitet wurde.


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

Beachten Sie, dass anstelle von {subscriptionId} in der Ausgabe die tatsächliche Abonnement-ID angezeigt wird.

Überprüfen des direkten Peerings

Führen Sie zum Abrufen der Liste der Peerings den Befehl Get-AzPeering aus.

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

Das folgende Beispiel zeigt die Antwort, wenn die End-to-End-Bereitstellung erfolgreich abgeschlossen wurde.

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

Ändern des direkten Peerings

In diesem Abschnitt wird beschrieben, wie Sie die folgenden Änderungsvorgänge für Direct Peering ausführen:

  • Hinzufügen von Direct-Peeringverbindungen
  • Entfernen von Direct-Peeringverbindungen
  • Upgrade oder Downgrade der Bandbreite in aktiven Verbindungen
  • Hinzufügen von IPv4-/IPv6-Sitzungen in aktiven Verbindungen
  • Entfernen von IPv4-/IPv6-Sitzungen aus aktiven Verbindungen

Hinzufügen von Direct Peering-Verbindungen

Das folgende Beispiel beschreibt, wie Sie einem vorhandenen Direct-Peering Verbindungen hinzufügen.


$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

Entfernen von Direct Peering-Verbindungen

Das Entfernen einer Verbindung mit PowerShell wird derzeit nicht unterstützt. Wenden Sie sich für weitere Informationen an das Microsoft-Peering-Team.

Upgrade oder Downgrade der Bandbreite in aktiven Verbindungen

Dieses Beispiel beschreibt, wie Sie einer Direct-Verbindung 10 GBit/s hinzufügen.


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

Hinzufügen von IPv4-/IPv6-Sitzungen in aktiven Verbindungen

In diesem Beispiel wird beschrieben, wie Sie einer vorhandenen Direct-Verbindung, die nur über eine IPv4-Sitzung verfügt, eine IPv6-Sitzung hinzufügen.


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

Entfernen von IPv4-/IPv6-Sitzungen aus aktiven Verbindungen

Das Entfernen einer IPv4-/IPv6-Sitzung aus einer vorhandenen Verbindung wird mit PowerShell derzeit nicht unterstützt. Wenden Sie sich für weitere Informationen an das Microsoft-Peering-Team.

Aufheben der Bereitstellung eines direkten Peerings

Die Aufhebung der Bereitstellung über das Azure-Portal oder PowerShell wird derzeit nicht unterstützt. Wenden Sie sich zum Aufheben des Peerings an das Microsoft-Peering-Team.

Zusätzliche Ressourcen

Ausführliche Beschreibungen aller Parameter erhalten Sie, wenn Sie den folgenden Befehl ausführen:

Get-Help Get-AzPeering -detailed

Nächste Schritte