Migrieren zu Azure Cloud Services (erweiterter Support) mit PowerShell

  • Artikel

In den folgenden Schritten wird gezeigt, wie Sie mit Azure PowerShell-Befehlen von Cloud Services (klassisch) zu Cloud Services (erweiterter Support) migrieren.

Plan für die Migration

Die Planung ist der wichtigste Schritt für eine erfolgreiche Migration. Lesen Sie die Übersicht zu Cloud Services (erweiterter Support) und den Artikel Planen der Migration von IaaS-Ressourcen vom klassischen Bereitstellungsmodell zu Azure Resource Manager, bevor Sie mit den Migrationsschritten beginnen.

Installieren Sie die neuesten Version von PowerShell.

Für die Installation von Azure PowerShell stehen zwei Hauptoptionen zur Verfügung: PowerShell-Katalog oder Webplattform-Installer (WebPI). WebPI empfängt monatliche Updates. Der PowerShell-Katalog wird fortlaufend aktualisiert. Dieser Artikel basiert auf Azure PowerShell Version 2.1.0.

Installationsanweisungen finden Sie unter Installieren und Konfigurieren von Azure PowerShell.

Sicherstellen der Administratorberechtigungen

Um diese Migration auszuführen, müssen Sie im Azure-Portal als Co-Administrator für das Abonnement hinzugefügt werden.

  1. Melden Sie sich beim Azure-Portal an.
  2. Wählen Sie im Menü Hub die Option Abonnement aus. Wählen Sie Alle Dienste aus, falls die Option nicht angezeigt wird.
  3. Suchen Sie den entsprechenden Abonnementeintrag, und prüfen Sie dann das Feld MEINE ROLLE. Bei einem Co-Administrator muss der Wert Kontoadministrator lauten.

Wenn Sie keinen Co-Administrator hinzufügen können, wenden Sie sich an einen Dienstadministrator oder Co-Administrator für das Abonnement, um sich hinzufügen zu lassen.

Registrieren des klassischen Anbieters und des CloudService-Features

Starten Sie zunächst eine PowerShell-Eingabeaufforderung. Für die Migration richten Sie Ihre Umgebung sowohl für das klassische Bereitstellungsmodell als auch für Resource Manager ein.

Melden Sie sich an Ihrem Konto für das Resource Manager-Modell an.

Connect-AzAccount

Rufen Sie die verfügbaren Abonnements mit dem folgenden Befehl ab:

Get-AzSubscription | Sort Name | Select Name

Legen Sie Ihr Azure-Abonnement für die aktuelle Sitzung fest. In diesem Beispiel wird der Abonnementname standardmäßig auf My Azure Subscription festgelegt. Ersetzen Sie den Abonnementnamen im Beispiel durch den Namen Ihres eigenen Abonnements.

Select-AzSubscription –SubscriptionName "My Azure Subscription"

Registrieren Sie sich mithilfe des folgenden Befehls beim Migrationsressourcenanbieter:

Register-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate

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.

Registrieren Sie das CloudServices-Feature für Ihr Abonnement. Die Registrierung kann mehrere Minuten dauern.

Register-AzProviderFeature -FeatureName CloudServices -ProviderNamespace Microsoft.Compute

Warten Sie fünf Minuten, bis die Registrierung abgeschlossen wird.

Überprüfen Sie den Genehmigungsstatus des klassischen Anbieters mit dem folgenden Befehl:

Get-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate

Überprüfen Sie den Status der Registrierung mit dem folgenden Befehl:

Get-AzProviderFeature -FeatureName CloudServices -ProviderNamespace Microsoft.Compute

Stellen Sie sicher, dass der RegistrationState-Wert für beide Registered lautet, bevor Sie fortfahren.

Vergewissern Sie sich vor dem Wechsel zum klassischen Bereitstellungsmodell, dass Sie in der Azure-Region Ihrer aktuellen Bereitstellung oder Ihres aktuellen virtuellen Netzwerks über ein ausreichendes Azure Resource Manager-vCPU-Kontingent verfügen. Mit dem folgenden PowerShell-Befehl können Sie die aktuelle Anzahl von vCPUs in Azure Resource Manager überprüfen. Weitere Informationen zu vCPU-Kontingenten finden Sie unter Grenzwerte und der Azure Resource Manager.

In diesem Beispiel wird die Verfügbarkeit in der Region USA, Westen geprüft. Ersetzen Sie den Regionsnamen im Beispiel durch den Namen Ihrer eigenen Region.

Get-AzVMUsage -Location "West US"

Melden Sie sich jetzt bei Ihrem Konto für das klassische Bereitstellungsmodell an.

Add-AzureAccount

Rufen Sie die verfügbaren Abonnements mit dem folgenden Befehl ab:

Get-AzureSubscription | Sort SubscriptionName | Select SubscriptionName

Legen Sie Ihr Azure-Abonnement für die aktuelle Sitzung fest. In diesem Beispiel wird das Abonnement standardmäßig auf My Azure Subscription festgelegt. Ersetzen Sie den Abonnementnamen im Beispiel durch den Namen Ihres eigenen Abonnements.

Select-AzureSubscription –SubscriptionName "My Azure Subscription"

Migrieren Ihrer Cloud Services-Instanzen

Bevor Sie mit der Migration beginnen, sollten Sie verstehen, wie die Migrationsschritte funktionieren und welchen Zweck sie jeweils haben.

Hinweis

Alle hier beschriebenen Vorgänge sind idempotent. Sollte ein Problem auftreten, das nicht auf ein nicht unterstütztes Feature oder auf einen Konfigurationsfehler zurückzuführen ist, wiederholen Sie den Vorbereitungs-, Abbruch- oder Commitvorgang. Die Plattform versucht dann erneut, die Aktion auszuführen.

Option 1: Migrieren eines Clouddiensts (nicht in einem virtuellen Netzwerk)

Verwenden Sie den folgenden Befehl, um die Liste der Clouddienste abzurufen. Wählen Sie dann den Clouddienst aus, den Sie migrieren möchten.

Get-AzureService | ft Servicename

Rufen Sie den Bereitstellungsnamen für den Clouddienst ab. In diesem Beispiel lautet der Dienstname My Service. Ersetzen Sie den Dienstnamen im Beispiel durch den Namen Ihres eigenen Diensts.

$serviceName = "My Service"
$deployment = Get-AzureDeployment -ServiceName $serviceName
$deploymentName = $deployment.DeploymentName

Überprüfen Sie zuerst mit folgenden Befehlen, ob Sie den Clouddienst migrieren können. Der Befehl zeigt ggf. Fehler an, die die Migration blockieren.

$validate = Move-AzureService -Validate -ServiceName $serviceName -DeploymentName $deploymentName -CreateNewVirtualNetwork
$validate.ValidationMessages

Wenn die Überprüfung erfolgreich ist, Fahren Sie im nächsten Schritt mit der Vorbereitung fort.

Move-AzureService -Prepare -ServiceName $serviceName -DeploymentName $deploymentName -CreateNewVirtualNetwork

Überprüfen Sie die Konfiguration für den vorbereiteten Clouddienst (erweiterter Support) entweder mit Azure PowerShell oder im Azure-Portal. Wenn Sie noch nicht für die Migration bereit sind und zum alten Zustand zurückkehren möchten, brechen Sie die Migration ab.

Move-AzureService -Abort -ServiceName $serviceName -DeploymentName $deploymentName

Wenn Sie bereit sind, die Migration durchzuführen, führen Sie einen Commit aus.

Move-AzureService -Commit -ServiceName $serviceName -DeploymentName $deploymentName

Option 2: Migrieren eines Clouddiensts (in einem virtuellen Netzwerk)

Um einen Clouddienst in einem virtuellen Netzwerk zu migrieren, migrieren Sie das virtuelle Netzwerk. Der Clouddienst wird automatisch mit dem virtuellen Netzwerk migriert.

Hinweis

Der Name des virtuellen Netzwerks kann von dem Namen abweichen, der im neuen Portal angezeigt wird. Im neuen Azure-Portal wird der Name als [vnet-name] angezeigt, der tatsächliche Name des virtuellen Netzwerks ist jedoch vom Typ Group [resource-group-name] [vnet-name]. Suchen Sie vor dem Start der Migration anhand des Befehls Get-AzureVnetSite | Select -Property Name den tatsächlichen Namen des virtuellen Netzwerks, oder zeigen Sie ihn im alten Azure-Portal an.

In diesem Beispiel wird der Name des virtuellen Netzwerks auf myVnet festgelegt. Ersetzen Sie den Namen des virtuellen Netzwerks im Beispiel durch den Namen Ihres eigenen virtuellen Netzwerks.

$vnetName = "myVnet"

Überprüfen Sie zuerst mithilfe des folgenden Befehls, ob Sie das virtuelle Netzwerk migrieren können:

Move-AzureVirtualNetwork -Validate -VirtualNetworkName $vnetName

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

Move-AzureVirtualNetwork -Prepare -VirtualNetworkName $vnetName

Überprüfen Sie die Konfiguration für den vorbereiteten Clouddienst (erweiterter Support) entweder mit Azure PowerShell oder im Azure-Portal. 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

Wenn die vorbereitete Konfiguration in Ordnung ist, können Sie den Vorgang fortsetzen und mithilfe des folgenden Befehls ein Commit für die Ressourcen ausführen:

Move-AzureVirtualNetwork -Commit -VirtualNetworkName $vnetName

Nächste Schritte

Lesen Sie den Abschnitt Änderungen nach der Migration, um Änderungen in Bereitstellungsdateien, bei der Automatisierung und bei anderen Attributen der neuen Cloud Services-Bereitstellung (erweiterter Support) anzuzeigen.