Konvertieren eines älteren direkten Peerings in eine Azure-Ressource mithilfe von PowerShell
In diesem Artikel wird beschrieben, wie Sie mithilfe von PowerShell-Cmdlets ein vorhandenes Legacy-Direct-Peering in eine Azure-Ressource konvertieren.
Sie können diese Anleitung auch im Azure-Portal durchführen, wenn Sie das vorziehen.
Voraussetzungen
- Informieren Sie sich vor der Konfiguration zunächst über die Voraussetzungen, und lesen Sie den Artikel Exemplarische Vorgehensweise für direktes Peering.
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. |  |
| Wählen Sie die Schaltfläche Cloud Shell auf der Symbolleiste rechts oben im Azure-Portal 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 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.
Konvertieren einer Legacyinstanz für direktes Peering in eine Azure-Ressource
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.
Installieren und importieren Sie das Az-Modul.
Install-Module Az -AllowClobber Import-Module AzInstallieren 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-ModuleMelden Sie sich mit diesem Befehl bei Ihrem Azure-Konto an:
Connect-AzAccountSehen 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"
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 eines Legacy-Direct-Peerings für die Konvertierung
In diesem Beispiel wird zeigt, wie Sie ein Legacy-Direct-Peering am Peeringstandort Seattle abrufen.
$legacyPeering = Get-AzLegacyPeering `
-Kind Direct -PeeringLocation "Seattle"
$legacyPeering
Hier sehen Sie eine Beispielantwort:
Name :
Sku : Basic_Direct_Free
Kind : Direct
PeeringLocation : Seattle
UseForPeeringService : False
PeerAsn.Id :
Connection : ------------------------
PeeringDBFacilityId : 71
SessionPrefixIPv4 : 4.71.156.72/30
PeerSessionIPv4Address : 4.71.156.73
MicrosoftIPv4Address : 4.71.156.74
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
SessionPrefixIPv6 : 2001:1900:2100::1e10/126
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
BandwidthInMbps : 0
ProvisionedBandwidthInMbps : 20000
Connection : ------------------------
PeeringDBFacilityId : 71
SessionPrefixIPv4 : 4.68.70.140/30
PeerSessionIPv4Address : 4.68.70.141
MicrosoftIPv4Address : 4.68.70.142
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
SessionPrefixIPv6 : 2001:1900:4:3::cc/126
PeerSessionIPv6Address : 2001:1900:4:3::cd
MicrosoftIPv6Address : 2001:1900:4:3::ce
SessionStateV6 : Established
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
BandwidthInMbps : 0
ProvisionedBandwidthInMbps : 20000
ProvisioningState : Succeeded
Konvertieren einer Legacyinstanz für direktes Peering
Wichtig
Änderungen werden beim Konvertieren eines Legacy-Peerings in eine Azure-Ressource nicht unterstützt.
Verwenden Sie diesen Befehl, um ein Legacy-Direct-Peering in eine Azure-Ressource zu konvertieren:
$legacyPeering[0] | New-AzPeering `
-Name "SeattleDirectPeering" `
-ResourceGroupName "PeeringResourceGroup" `
Hier sehen Sie eine Beispielantwort:
Name : SeattleDirectPeering
Sku.Name : Basic_Direct_Free
Kind : Direct
Connections : {11, 11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{asnNumber}
UseForPeeringService : False
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : centralus
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
Type : Microsoft.Peering/peerings
Tags : {}
Zusätzliche Ressourcen
Ausführliche Beschreibungen aller Parameter erhalten Sie, wenn Sie diesen Befehl ausführen:
Get-Help Get-AzPeering -detailed