Zuordnen der Peer-ASN zum Azure-Abonnement mithilfe von PowerShell

  • Artikel

Bevor Sie eine Peeringanforderung übermitteln, sollten Sie Zunächst Ihr ASN mit Azure-Abonnement verknüpfen, indem Sie die Schritte in diesem Artikel ausführen.

Wenn Sie es vorziehen, können Sie diesen Leitfaden mit dem Azure-Portal abschließen.

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 in the 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 einer PeerASN zum Zuordnen Ihrer ASN zum Azure-Abonnement

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.  

Für Peeringressourcenanbieter registrieren

Registrieren Sie sich für peering-Ressourcenanbieter in Ihrem Abonnement mit Register-AzResourceProvider. Wenn Sie dies nicht ausführen, sind azure-Ressourcen, die zum Einrichten von Peering erforderlich sind, nicht zugänglich.

Register-AzResourceProvider -ProviderNamespace Microsoft.Peering

Sie können den Registrierungsstatus mit Get-AzResourceProvider überprüfen:

Get-AzResourceProvider -ProviderNamespace Microsoft.Peering

Wichtig

Warten Sie, bis RegistrationState zu „Registriert“ wechselt, bevor Sie fortfahren. Dies kann 5 bis 30 Minuten dauern, nachdem Sie den Befehl ausgeführt haben.

Aktualisieren der diesem Abonnement zugeordneten Peerinformationen

Aktualisieren Sie die Peerinformationen, die diesem Abonnement zugeordnet sind, mithilfe von New-AzPeerAsn:

$contactDetails = New-AzPeerAsnContactDetail -Role Noc -Email "noc@contoso.com" -Phone "+1 (555) 555-5555"
New-AzPeerAsn -Name "Contoso_1234" -PeerName "Contoso" -PeerAsn 1234 -ContactDetail $contactDetails

Hinweis

-Name entspricht dem Ressourcennamen und ist frei wählbar. -peerName entspricht jedoch dem Namen Ihres Unternehmens und muss so nah wie möglich an Ihrem PeeringDB-Profil sein. Beachten Sie, dass der Wert für -peerName nur die Zeichen a–z, A–Z und Leerzeichen unterstützt.

Ein Abonnement kann über mehrere ASNs verfügen. Aktualisieren Sie die Peeringinformationen für jede ASN. Achten Sie darauf, dass „name“ für jede ASN eindeutig ist.

Von Peers wird erwartet, dass sie über ein umfassendes und aktuelles Profil auf PeeringDB verfügen. Wir verwenden diese Informationen während der Registrierung, um die Detailangaben des Peers zu überprüfen, wie etwa die NOC-Informationen, Informationen zum technischen Kontakt, die Anwesenheit in den Peeringeinrichtungen usw.

Anstelle von {subscriptionId} in der Ausgabe wird die tatsächliche Abonnement-ID angezeigt.

Anzeigestatus einer PeerASN

Überprüfen Sie den STATUS der ASN-Überprüfung mithilfe von Get-AzPeerAsn:

Get-AzPeerAsn

Unten finden Sie eine Beispielantwort:

PeerContactInfo : Microsoft.Azure.PowerShell.Cmdlets.Peering.Models.PSContactInfo
PeerName        : Contoso
ValidationState : Approved
PeerAsnProperty : 1234
Name            : Contoso_1234
Id              : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/Contoso_1234
Type            : Microsoft.Peering/peerAsns

Wichtig

Warten Sie, bis der ValidationState sich in „Genehmigt“ geändert hat, bevor Sie eine Peeringanforderung einreichen. Diese Genehmigung kann bis zu 12 Stunden dauern.

PeerAsn ändern

Sie können NOC-Kontaktinformationen jederzeit mithilfe von Set-AzPeerAsn ändern:

Set-AzPeerAsn -Name Contoso_1234 -Email "newemail@test.com" -Phone "1800-000-0000"

PeerAsn löschen

Das Löschen eines PeerASN wird derzeit nicht unterstützt. Wenn Sie die PeerASN löschen müssen, wenden Sie sich an Microsoft Peering.

Nächste Schritte