Migrieren eines virtuellen Azure-Netzwerks von der klassischen Bereitstellung zu Resource Manager mithilfe von Azure PowerShell

In diesem Artikel erfahren Sie, wie Sie vom klassischen Bereitstellungsmodell zum neueren Resource Manager-Bereitstellungsmodell migrieren.

Die Migration von der klassischen Bereitstellung zu Resource Manager erfolgt immer nur für jeweils ein virtuelles Netzwerk. Es gibt keine zusätzliche Anforderung für Tools oder Voraussetzungen für die Migration, mit Ausnahme der Azure PowerShell-Anforderungen. Bei der Migration handelt es sich um eine Migration der virtuellen Netzwerkressource auf der Steuerungsebene. Während der Migration gibt es keine Ausfallzeiten im Datenpfad. Vorhandene Workloads funktionieren während der Migration weiterhin ohne Verlust der Konnektivität. Die dem virtuellen Netzwerk zugeordneten öffentlichen IP-Adressen ändern sich während des Migrationsprozesses nicht.

Nach Abschluss der Migration müssen alle Verwaltungsvorgänge mithilfe des Resource Manager-Modells ausgeführt werden. Auf Verwaltungsvorgänge kann nur über das Resource Manager-Bereitstellungsmodell zugegriffen werden. Änderungen der Subnetz- oder virtuellen Netzwerkressourcen sind über das alte Bereitstellungsmodell nicht mehr verfügbar.

Wenn Sie das virtuelle Netzwerk vom klassischen zum Resource Manager-Modell migrieren, werden die unterstützten Ressourcen im virtuellen Netzwerk automatisch zum neuen Modell migriert.

Voraussetzungen

  • Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto.
  • Die Schritte und Beispiele in diesem Artikel verwenden das Azure PowerShell Az-Modul. 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, kann es mit den in den Anweisungen angegebenen Werten zu Fehlern kommen. Um die installierten Versionen von PowerShell auf Ihrem System zu finden, verwenden Sie das Cmdlet Get-Module -ListAvailable Az.
  • Zum Migrieren eines virtuellen Netzwerks mit einem Anwendungsgateway entfernen Sie das Gateway, bevor Sie einen Vorbereitungsvorgang zum Verschieben des Netzwerks ausführen. Stellen Sie nach Abschluss der Migration die Verbindung zum Gateway im Azure Resource Manager wieder her.
  • Stellen Sie sicher, dass Sie das klassische und das Az Azure PowerShell-Modul lokal auf Ihrem Computer installiert haben. Weitere Informationen finden Sie unter Installieren und Konfigurieren von Azure PowerShell.
  • Azure ExpressRoute-Gateways, die sich mit ExpressRoute-Verbindungen in einem anderen Abonnement verbinden, können nicht automatisch migriert werden. Entfernen Sie in diesen Fällen das ExpressRoute-Gateway, migrieren Sie das virtuelle Netzwerk, und erstellen Sie das Gateway neu.

Unterstützte Szenarios

Die folgenden Szenarien werden für eine Migration vom klassischen Modell zu Resource Manager unterstützt:

  • Klassische virtuelle Netzwerke mit virtuellen Computern.

  • Klassische virtuelle Netzwerke mit maximal einer Verfügbarkeitsgruppe pro Clouddienst.

  • Klassische virtuelle Netzwerke, die Microsoft Entra Domain Services enthalten.

  • Klassische virtuelle Netzwerke mit einem einzelnen VPN-Gateway oder einer einzelnen ExpressRoute-Verbindung.

Nicht unterstützte Szenarien

Die folgenden Szenarien werden für die Migration nicht unterstützt:

  • Verwalten des Lebenszyklus eines virtuellen Netzwerks aus dem klassischen Bereitstellungsmodell.

  • Unterstützung der rollenbasierten Zugriffssteuerung von Azure (Role-Based Access Control, RBAC) für das klassische Bereitstellungsmodell.

  • Migration von virtuellen Netzwerken sowohl mit einem ExpressRoute-Gateway als auch mit einem VPN-Gateway.

  • Migration virtueller Netzwerke mit mehr als einer Verfügbarkeitsgruppe in einem einzelnen Clouddienst.

  • Migration virtueller Netzwerke mit mindestens einer Verfügbarkeitsgruppe und virtuellen Computern, die sich nicht in einer Verfügbarkeitsgruppe in einem einzelnen Clouddienst befinden.

  • Migration von Anwendungsgateways vom klassischen Modell zu Resource Manager.

Registrieren des Ressourcenanbieters

In diesem Abschnitt melden Sie sich mit den Resource Manager-Cmdlets bei Ihrem Abonnement an und registrieren den Migrationsressourcenanbieter.

  1. Melden Sie sich bei Azure PowerShell an:

    Connect-AzAccount
    
    
  2. Registrieren Sie den Migrationsressourcenanbieter:

    Register-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate
    
    

    Warten Sie fünf Minuten, bis die Registrierung abgeschlossen wird. Überprüfen Sie den Status der Registrierung mithilfe des folgenden Befehls:

    Get-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate
    
    

    Vergewissern Sie sich, dass der RegistrationStateRegistered lautet, bevor Sie fortfahren.

    Hinweis

    Die Registrierung ist ein einmaliger Schritt, der jedoch einmal ausgeführt werden muss, bevor Sie versuchen, die Migration auszuführen. Ohne Registrierung wird die folgende Fehlermeldung angezeigt:

    BadRequest: Das Abonnement ist nicht für die Migration registriert.

Abrufen des Namens des zu migrierenden virtuellen Netzwerks

In diesem Abschnitt melden Sie sich bei der PowerShell des klassischen Bereitstellungsmodells an und rufen den Namen des virtuellen Netzwerks ab, das migriert werden soll.

  1. Melden Sie sich bei der PowerShell der klassischen Bereitstellung an:

    Add-AzureAccount
    
    
  2. Führen Sie den folgenden Befehl aus, um den Namen des klassischen virtuellen Netzwerks abzurufen:

    Get-AzureVnetSite | Select -Property Name
    
    

Notieren Sie sich den Namen des virtuellen Netzwerks für den nächsten Abschnitt.

Migrieren des virtuellen Netzwerks

In diesem Abschnitt überprüfen Sie, ob die Migration fortgesetzt werden kann, und bereiten dann die Migration vor.

  1. Platzieren Sie den Namen des virtuellen Netzwerks, den Sie sich im vorherigen Abschnitt notiert haben, zur Verwendung durch die Befehle in einer Variable. Ersetzen Sie myVNet durch den Namen des virtuellen Netzwerks, das Sie im vorherigen Abschnitt abgerufen haben:

    $vnetname = "myVNet"
    
    
  2. Überprüfen Sie zuerst mithilfe des folgenden Befehls, ob Sie das virtuelle Netzwerk migrieren können:

    Move-AzureVirtualNetwork -Validate -VirtualNetworkName $vnetName
    
    

    Der Befehl zeigt alle Warnungen oder Fehler an, die die Migration blockieren. Wenn die Überprüfung erfolgreich ist, können Sie mit dem folgenden Vorbereitungsschritt fortfahren:

    Hinweis

    Wenn das virtuelle Netzwerk Web- oder Workerrollen oder virtuelle Computer mit nicht unterstützten Konfigurationen enthält, tritt ein Überprüfungsfehler auf.

  3. Führen Sie den folgenden Befehl aus, um das virtuelle Netzwerk für die Migration vorzubereiten:

    Move-AzureVirtualNetwork -Prepare -VirtualNetworkName $vnetName
    
    

    Wenn Sie noch nicht für die Migration bereit sind und zum alten Zustand zurückkehren möchten, verwenden Sie den folgenden Befehl:

    Move-AzureVirtualNetwork -Abort -VirtualNetworkName $vnetName
    

Committen der Migration

Wenn in der vorbereiteten Konfiguration alles gut aussieht, können Sie die Migration durch Ausführen des folgenden Befehls committen:

Move-AzureVirtualNetwork -Commit -VirtualNetworkName $vnetName

Nächste Schritte

Weitere Informationen zum Migrieren von Ressourcen in Azure vom klassischen Modell zu Resource Manager finden Sie unter: