Umstellen von ExpressRoute-Verbindungen vom klassischen auf das Resource Manager-Bereitstellungsmodell mithilfe von PowerShell

  • Artikel

Damit Sie eine ExpressRoute-Verbindung sowohl für das klassische Bereitstellungsmodell als auch für das Resource Manager-Bereitstellungsmodell verwenden können, müssen Sie die Verbindung in das Resource Manager-Bereitstellungsmodell verschieben. In den folgenden Abschnitten wird erläutert, wie Sie Ihre Verbindung mithilfe von PowerShell umstellen können.

Voraussetzungen

Die Schritte und Beispiele in diesem Artikel verwenden Azure PowerShell Az-Module. Informationen zur lokalen Installation von Az-Modulen auf Ihrem Computer finden Sie unter Installieren von Azure PowerShell. Weitere Informationen zum neuen Az-Modul finden Sie unter Einführung in das neue Azure PowerShell Az-Modul. PowerShell-Cmdlets werden regelmäßig aktualisiert. Wenn Sie nicht die neueste Version verwenden, können die in den Anweisungen angegebenen Werte fehlschlagen. Um die installierten Versionen von PowerShell auf Ihrem System zu suchen, verwenden Sie das Get-Module -ListAvailable Az-Cmdlet.

Verschieben einer ExpressRoute-Verbindung

Schritt 1: Abrufen von Verbindungsdetails aus dem klassischen Bereitstellungsmodell

Melden Sie sich bei der klassischen Azure-Umgebung an, und rufen Sie den Dienstschlüssel ab.

  1. Melden Sie sich bei Ihrem Azure-Konto an.

    Add-AzureAccount

  2. Wählen Sie das entsprechende Azure-Abonnement.

    Select-AzureSubscription "<Enter Subscription Name here>"

  3. Importieren Sie die PowerShell-Module für Azure und ExpressRoute.

    Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\Azure\Azure.psd1'
Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\ExpressRoute\ExpressRoute.psd1'

  4. Verwenden Sie das Cmdlet weiter unten, um die Dienstschlüssel für alle ExpressRoute-Verbindungen abzurufen. Kopieren Sie nach dem Abrufen der Schlüssel den Dienstschlüssel der Verbindung, die Sie in das Resource Manager-Bereitstellungsmodell verschieben möchten.

    Get-AzureDedicatedCircuit

Schritt 2: Anmelden und Erstellen einer Ressourcengruppe

Melden Sie sich bei der Resource Manager-Umgebung an, und erstellen Sie eine neue Ressourcengruppe.

  1. Melden Sie sich bei Ihrer Azure Resource Manager-Umgebung an.

    Connect-AzAccount

  2. Wählen Sie das entsprechende Azure-Abonnement.

    Get-AzSubscription -SubscriptionName "<Enter Subscription Name here>" | Select-AzSubscription

  3. Ändern Sie den Codeausschnitt unten, um eine neue Ressourcengruppe zu erstellen, falls Sie noch keine besitzen.

    New-AzResourceGroup -Name "DemoRG" -Location "West US"

Schritt 3: Verschieben der ExpressRoute-Verbindung in das Resource Manager-Bereitstellungsmodell

Sie können Ihre ExpressRoute-Verbindung jetzt vom klassischen Bereitstellungsmodell in das Resource Manager-Bereitstellungsmodell verschieben. Bevor Sie fortfahren, lesen Sie die Informationen im Artikel Verschieben von ExpressRoute-Verbindungen vom klassischen zum Resource Manager-Bereitstellungsmodell.

Ändern Sie zum Verschieben den folgenden Codeausschnitt, und führen Sie ihn aus:

Move-AzExpressRouteCircuit -Name "MyCircuit" -ResourceGroupName "DemoRG" -Location "West US" -ServiceKey "<Service-key>"

Im klassischen Modus basiert eine ExpressRoute-Verbindung nicht auf einer Verknüpfung mit einer Region. In Resource Manager muss jedoch jede Ressource einer Azure-Region zugeordnet sein. Bei der im Cmdlet „Move-AzExpressRouteCircuit“ angegebenen Region kann es sich aus technischer Sicht um eine beliebige Region handeln. Für organisatorische Zwecke empfiehlt es sich, eine Region auszuwählen, die den Peeringstandort genau darstellt.

Hinweis

  • Nachdem Sie die klassische ExpressRoute-Verbindung in das Resource Manager-Bereitstellungsmodell verschoben haben, hat sie standardmäßig Zugriff auf beide Bereitstellungsmodelle (klassische und Resource Manager-Bereitstellung).
  • Der neue Name (der im vorherigen Cmdlet aufgeführt wurde) wird zum Verweisen auf die Ressource verwendet. Die Verbindung wird im Grunde umbenannt.

Ändern des Verbindungszugriffs

So aktivieren Sie eine ExpressRoute-Verbindung für beide Bereitstellungsmodelle

Sie können den Zugriff auf das klassische Bereitstellungsmodell für ExpressRoute-Verbindungen aktivieren, die mit dem Resource Manager-Bereitstellungsmodell erstellt wurden. Führen Sie die folgenden Cmdlets aus, um den Zugriff auf beide Bereitstellungsmodelle zu aktivieren:

  1. Rufen Sie die Verbindungsdetails ab.

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"

  2. Legen Sie „Klassische Vorgänge zulassen“ auf TRUE fest.

    $ckt.AllowClassicOperations = $true

  3. Aktualisieren Sie die Verbindung. Nachdem dieser Vorgang erfolgreich abgeschlossen wurde, können Sie die Verbindung im klassischen Bereitstellungsmodell anzeigen.

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

  4. Führen Sie das folgende Cmdlet aus, um die Details zur ExpressRoute-Verbindung abzurufen. Sie müssen in der Lage sein, den aufgeführten Dienstschlüssel anzuzeigen.

    get-azurededicatedcircuit

  5. Sie können jetzt Verknüpfungen mit der ExpressRoute-Verbindung mithilfe der Befehle des klassischen Bereitstellungsmodells für klassische VNets und mithilfe der Resource Manager-Befehle für Resource Manager-VNETs verwalten. In den folgenden Artikeln wird beschrieben, wie Sie Verknüpfungen mit der ExpressRoute-Verbindung verwalten können:

So deaktivieren Sie die ExpressRoute-Verbindung für das klassische Bereitstellungsmodell

Führen Sie die folgenden Cmdlets aus, um den Zugriff auf das klassische Bereitstellungsmodell zu deaktivieren:

  1. Rufen Sie die Details der ExpressRoute-Verbindung ab.

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"

  2. Legen Sie „Klassische Vorgänge zulassen“ auf FALSE fest.

    $ckt.AllowClassicOperations = $false

  3. Aktualisieren Sie die Verbindung. Nachdem dieser Vorgang erfolgreich abgeschlossen wurde, können Sie die Verbindung im klassischen Bereitstellungsmodell nicht mehr anzeigen.

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

Nächste Schritte