Erstellen oder Ändern eines Direct Peering mit PowerShell

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

Bevor Sie beginnen

Überprüfen Sie die Voraussetzungen und die Anleitung für Direct Peering, bevor Sie mit der Konfiguration beginnen.
Falls Sie bereits Direct Peering-Verbindungen mit Microsoft eingerichtet haben, die nicht in Azure-Ressourcen konvertiert werden, lesen Sie die Informationen unter Konvertieren eines Legacy-Direct Peerings in eine Azure-Ressource mithilfe der PowerShell.

Arbeiten mit Azure PowerShell

Um die Cmdlets auszuführen, können Sie Azure Cloud Shell verwenden, eine kostenlose interaktive Shell. Sie verfügt über die üblichen vorinstallierten Azure-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. Wählen Sie dann Enter aus, um es auszuführen. Cloud Shell kann auf mehrere Arten gestartet werden:

Startmethode	Bildschirmfoto
Öffnen Sie Cloud Shell in Ihrem Browser.
Wählen Sie auf der Symbolleiste oben rechts im Azure-Portal die Schaltfläche "Cloud Shell " aus.

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 häufig aktualisiert. Sie müssen Ihre PowerShell-Cmdlets in der Regel aktualisieren, um die neuesten Features und Funktionen nutzen zu können. Wenn Sie es nicht tun, könnten Sie auf Probleme stoßen.

Um die Version von PowerShell zu finden, 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, führen Sie die Schritte zum Installieren von PowerShell unter macOS aus.

Erstellen und Bereitstellen eines direkten Peerings

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

Installieren und importieren Sie das Az-Modul.

Install-Module Az -AllowClobber
Import-Module Az

Installieren und importieren Sie das Az.Peering-Modul.

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

Überprüfen Sie mithilfe des folgenden Befehls, ob die Module ordnungsgemäß importiert wurden:
```
Get-Module
```
Melden Sie sich mit diesem Befehl bei Ihrem Azure-Konto an:
```
Connect-AzAccount
```
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"
```
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"
```

Von Bedeutung

Wenn Sie Ihre ASN und Ihr Abonnement noch nicht zugeordnet haben, führen Sie die Schritte zur Zuordnung von Peer-ASN aus. Um ein Peering anzufordern, ist diese Aktion erforderlich.

Hinweis

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

Rufen Sie die Liste der unterstützten Peering-Standorte für Direktes Peering ab

Das PowerShell-Cmdlet Get-AzPeeringLocation gibt eine Liste von Peeringspeicherorten mit dem obligatorischen Parameter Kindzurück, den Sie in späteren Schritten verwenden werden.

Get-AzPeeringLocation -Kind Direct

Direct Peering-Standorte enthalten die folgenden Felder:

Peering-Standort
Land
PeeringDBFacilityId
PeeringDBFacilityLink
Bandbreitenangebote

Überprüfen Sie anhand der PeeringDB, ob Sie sich in der gewünschten Peering-Einrichtung befinden.

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

Um die Liste der Peerings abzurufen, führen Sie 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                 : {}

Direkt-Peering ändern

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

Hinzufügen von Direct-Peeringverbindungen
Entfernen Sie Direct-Peeringverbindungen.
Erhöhen oder Verringern der Bandbreite bei aktiven Verbindungen.
Hinzufügen von IPv4-/IPv6-Sitzungen auf 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. Für weitere Informationen wenden Sie sich an Microsoft-Peering.

Upgrade oder Downgrade der Bandbreite bei 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 Sie IPv4- oder IPv6-Sitzungen bei aktiven Verbindungen.

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

Aufheben der Bereitstellung eines direkten Peerings

Die Aufhebung der Bereitstellung über das Azure-Portal oder PowerShell wird derzeit nicht unterstützt. Wenden Sie sich für die Aufhebung an Microsoft-Peering.

Weitere Ressourcen

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

Get-Help Get-AzPeering -detailed

Nächste Schritte

Last updated on 2023-01-23