Freigeben über

Konvertieren eines älteren Exchange-Peerings in eine Azure-Ressource mithilfe von PowerShell

  • Artikel

In diesem Artikel wird beschrieben, wie Sie mithilfe von PowerShell-Cmdlets ein vorhandenes Legacy-Exchange Peering in eine Azure-Ressource konvertieren.

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 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.

Konvertieren einer Legacy-Instanz für Exchange 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.

  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 des Legacy-Exchange Peerings für die Konvertierung

Dieses Beispiel zeigt, wie Sie eine ältere Instanz für Exchange Peering an einem Peeringstandort in Seattle abrufen:

$legacyPeering = Get-AzLegacyPeering -Kind Exchange -PeeringLocation "Seattle"
$legacyPeering

Die Antwort kann wie folgt aussehen:

    Kind                     : Exchange
    PeeringLocation          : Seattle
    PeerAsn                  : 65000
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.100
    MicrosoftIPv4Address     : 10.21.31.50
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:100
    MicrosoftIPv6Address     : fe01::3e:50
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active

Legacy-Peering konvertieren

Dieser Befehl kann dazu verwendet werden, ein Legacy-Exchange Peering in eine Azure-Ressource zu konvertieren:

$legacyPeering[0] | New-AzPeering `
    -Name "SeattleExchangePeering" `
    -ResourceGroupName "PeeringResourceGroup"

 

Wichtig

Änderungen werden beim Konvertieren einer älteren Peering-Instanz in eine Azure-Ressource nicht unterstützt.  

Diese Beispielantwort wird angezeigt, wenn die End-to-End-Bereitstellung erfolgreich abgeschlossen wurde:

    Name                     : SeattleExchangePeering
    Kind                     : Exchange
    Sku                      : Basic_Exchange_Free
    PeeringLocation          : Seattle
    PeerAsn                  : 65000
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.100
    MicrosoftIPv4Address     : 10.21.31.50
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:100
    MicrosoftIPv6Address     : fe01::3e:50
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active

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