Aktivieren der Gastverwaltung für migrierte VMs

Gilt für: Azure Local 2503 und höher

In diesem Artikel wird beschrieben, wie Sie die Gastverwaltung nach der Migration für virtuelle Azure-Computer (VMs) aktivieren, die von Arc aktiviert sind.

Weitere Informationen zu anderen Szenarien finden Sie unter Verwalten lokaler Azure-VMs.

Die Ausgabeeigenschaften können variieren, je nachdem, ob VMs migriert wurden oder nicht.

Voraussetzungen

Bevor Sie beginnen, führen Sie die folgenden Schritte aus:

Sie haben Zugriff auf eine bereitgestellte und registrierte azure Local-Instanz, wobei eine Azure Arc-Ressourcenbrücke und ein benutzerdefinierter Standort konfiguriert ist.
Ihr System führt Azure Local Release 2405 oder höher aus.
Sie können eine Verbindung mit der lokalen Azure-Zielinstanz remote herstellen.
Machen Sie sich mit den lokalen Azure-VMs und Gastverwaltungsfeatures und Überlegungen vertraut – siehe Aktivieren der Gastverwaltung.
Überprüfen Sie die Liste der unterstützten Gastbetriebssysteme auf Azure Local. Siehe unterstützte Gastbetriebssysteme auf Azure Local.
Die lokale Azure-VM muss Zugriff auf öffentliche Netzwerkkonnektivität haben, um die Gastverwaltung zu aktivieren.

Aktivieren des Gast-Agents auf migrierten VMs

Alle Hyper-V Generation 1 VMs müssen ausgeschaltet werden, bevor mit den folgenden Schritten fortgefahren wird. Es gibt keine derartige Anforderung für Hyper-V Generation 2 VMs, die entweder ein- oder ausgeschaltet sein können, und beide Betriebszustände werden voraussichtlich funktionieren.

Schritt 1: Überprüfen Sie den Energiestatus der migrierten virtuellen Computer wie folgt:

Stellen Sie für Hyper-V Generation 1 sicher, dass der virtuelle Computer beendet ist. Lesen Sie den Anhang für die Fehlermeldung, wenn diese nicht gestoppt wird.

Verwenden von Azure-Portal (empfohlen)
1. Um die migrierte VM von Azure-Portal zu beenden, wählen Sie auf der Seite "VM-Details" die Option "Beenden" aus:
1. Warten Sie, und aktualisieren Sie die Seite, um zu sehen, dass der VM-Status als gestoppt angezeigt wird.
Verwenden der Azure CLI
1. Stellen Sie eine Verbindung mit dem lokalen Azure-Computer her, und öffnen Sie ein PowerShell-Fenster. Melden Sie sich mit Azure CLI an.
```
az login --use-device-code --tenant $tenantId
```
2. Überprüfen Sie den Energiestatus des virtuellen Computers mithilfe der Azure CLI wie folgt:
```
az stack-hci-vm show --name $vmName --resource-group $rgName --query "properties.status"
```
  Beispielausgabe:
```
PS C : \Users\AzureStackAdminD> az stack-hci-vm show --name <VM name> --resource-group <resource group> --query "properties.status"
{
    "errorCode":
    "errorMessage" :
    "powerstate": "Stopped",
    "provisioningstatus": null
}
```
Stellen Sie für VMs der Hyper-V-Generation 2 sicher, dass der Stromstatus, der auf Azure-Portal angezeigt wird, mit dem tatsächlichen Leistungsstatus des migrierten virtuellen Computers im Hyper-V-Manager übereinstimmt, unabhängig davon, ob er ein- oder ausgeschaltet ist:

Ansicht des Azure-Portal

Hyper-V-Manager-Ansicht

Schritt 2: Fügen Sie die ISO für den Gast-Agent auf der migrierten VM wie folgt an:

Stellen Sie eine Verbindung mit einem lokalen Azure-Computer her, und führen Sie den folgenden Befehl in PowerShell aus. Dabei $vmName handelt es sich um den Namen der migrierten VM, für die der Gast-Agent aktiviert ist, und $rgName der Name der Ressourcengruppe, in der sich dieser virtuelle Computer in Azure befindet:

az stack-hci-vm update --name $vmName --resource-group $rgName --enable-vm-config-agent true

Beispielausgabe:

PS C:\Users\AzureStackAdminD> az stack-hci-vm update --name $vmName -enable-vm-config-agent true --resource-group $resourceGroup
{
"endTime": "2024-08-19T22:01:22.1060463z",
"error": {},
"extendedLocation": null ,
"id": "<ID>",
"identity": null,
"name": "<Name>",
"properties": null,
"resourceld": "<Resource ID>",
"startTime": "2024-08-19T22: 01:09.4898702z" ,
"status": "Succeeded",
"systemData" : null,
"type": null
}

Beispielstatus der VM mit angefügter ISO-Datei, angezeigt aus dem lokalen Azure-System:

Schritt 3: Aktivieren Sie bei Bedarf die migrierte VM in Azure-Portal, und stellen Sie sicher, dass sie über eine öffentliche Netzwerkkonnektivität wie folgt verfügt:

Überprüfen Sie, ob der VM-Status im Azure-Portal Läuft:

Überprüfen Sie, ob der virtuelle Computer powerState ausgeführt wird, indem Sie den folgenden Befehl auf Ihrem lokalen Azure-Computer in einem PowerShell-Fenster ausführen:

az stack-hci-vm show --name $vmName --resource-group $rgName --query “properties.status”

PS C: \Users\AzureStackAdminD> az stack-hci-vm show --name <Name> --resource-group <Resource group> --query "properties.status" 
{
"errorCode":
"errorMessage":
"powerState": "Running",
"provisioningStatus": null
}

Schritt 4: Installieren Sie die Gast-Agent-ISO auf dem migrierten virtuellen Computer wie folgt:

Stellen Sie eine Verbindung mit dem virtuellen Computer her, indem Sie die entsprechenden betriebssystemspezifischen Schritte ausführen.
Richten Sie die Öffentliche Netzwerkkonnektivität auf dem virtuellen Computer ein.

Führen Sie den folgenden Befehl aus, um den Gast-Agent auf der VM basierend auf dem verwendeten Betriebssystem zu aktivieren:

Wenn Sie Linux verwenden, öffnen Sie Terminal und führen Sie den folgenden Befehl aus:

sudo -- sh -c 'mkdir /mociso && mount -L mocguestagentprov /mociso && bash /mociso/install.sh && umount /mociso && rm -df /mociso'

Beispielausgabe (Linux):

migration@migration-virtual-machine: $ sudo -- sh -c 'mkdir /mociso && mount -L mocguestagentprov /nociso && bash /mociso/install.sh && umount /mociso && rm -df/mociso && eject LABEL=mocguestagentprov'
[sudo] password for migration:
mount: /moctso: WARNING: device write-protected, mounted read-only.
Loading configuration version 've.16.5'...
The agent could not find the '/opt/mocguestagent/v0.16.5/config.yaml' config file. Looking for older versions to upgrade from...
Service installed.
Service started.
The guest agent was successfully installed.

Öffnen Sie PowerShell unter Windows als Administrator, und führen Sie Folgendes aus:

  $d=Get-Volume -FileSystemLabel mocguestagentprov;$p=Join-Path ($d.DriveLetter+':\') 'install.ps1';powershell $p

Beispielausgabe (Windows):

PS C:\Users\Administrator> $d=Get-Volume -FilesystemLabel mocguestagentprov;$p=Join-Path ($d.DriveLetter+':\') 'install ps1';powershell $p

Directory : C : \ProgramData\mocguestagent


Mode	LastWriteTime	Length Name
----    -------------   -----------
d------	8/19/2024	5:46 PM	certs
Loading configuration version 'v0.16.5'...
The agent could not find the 'C:\ProgramData\mocguestagent\v0.16.5\config.yaml' config file. Looking for older versions to upgrade from...
Service installed.
Service started.
The guest agent was successfully installed.

Aktivieren der Gastverwaltung

Sie können die Gastverwaltung aktivieren, nachdem der Gast-Agent läuft.

Aktivieren Sie die Gastverwaltung über Ihre lokale Azure-Instanz, indem Sie den folgenden Befehl in Azure CLI ausführen:

az stack-hci-vm update --name $vmName --resource-group $rgName --enable-agent true

Beispielausgabe:

PS C:\Users\AzureStackAdminD> az stack-hci-vm update --name $vmName --resource-group $resourceGroup --enable-agent true
{
"endTime": "2024-08-19T22:59:13.9583373Z”,
"error": {},
"extendedLocation" : null,
"id": "/<ID>",
"identity": null,
"name": "<Name>",
"properties": null,
"resourceld": "<Resource ID",
"startTime": "2024-08-19t22:28:23.8158331Z",
"status": "Succeeded",
"systemData": null,
"type": null
}

Überprüfen Sie den Status der Gastverwaltungsaktivierung in Azure-Portal:
Sie können jetzt die Azure-Erweiterungen Ihrer Wahl hinzufügen.

Wenn Probleme auftreten, wenden Sie sich an Microsoft-Support, und geben Sie Ihre Protokolle und Bereitstellungsdetails an.

Anhang

Wenn Sie vergessen haben, den virtuellen Computer der Hyper-V-Generation 1 vor dem Ausführen des Updatebefehls --enable-vm-config-agent truezu deaktivieren, schlägt der Updatebefehl fehl, und der virtuelle Computer kann von Azure-Portal nicht verwaltbar werden:

PS C:\Users\AzureStackAdminD> az stack-hci-vm update --name <VM name> -- resource-group <Resource group> --enable-vm-config-agent true
(Failed) moc-operator virtualmachine serviceclient returned an error while reconciling: rpc error: code = Unknown dasc = AddlSODisk for IsoFile mocguestagentprov.iso failed. Error: ErrorCode[32768] ErrorDescription[<VM name>' failed to add device 'Synthetic DVD Drive'. (Virtual machine ID <VM ID>)] ErrorSummaryDescription [Failed to add device 'Synthetic DVD Drive'.]: WMI Error 0x00008000: Failed
Code: Failed
Message: moc-operator virtualmachine serviceclient returned an error while reconciling: rpc error: code = Unknown desc = AddlSODisk for IsoFile mocguestagentprov.iso failed. Error: ErrorCode[32768] ErrorDescription['<VM name>' failed to add device 'Synthetic DVD Drive'. (Virtual machine ID <VM ID>)] ErrorSummaryDescription [Failed to add device 'Synthetic DVD Drive'.]: WMI Error 0x00008000: Failed

Um dies zu beheben, beenden Sie den virtuellen Computer in Azure-Portal, indem Sie "Beenden" auswählen. Wenn dies nicht funktioniert, führen Sie den folgenden Befehl über azure CLI aus:

az stack-hci-vm stop --name $vmName --resource-group $rgName

Möglicherweise sehen Sie im Azure-Portal einen Fehler "Ressource konnte nicht bereitgestellt werden", wobei die Optionen Start, Neustart und Beenden deaktiviert sind. Der Hyper-V-Manager sollte jedoch anzeigen, dass die virtuelle Maschine tatsächlich gestoppt ist.

az stack-hci-vm update --name $vmName --resource-group $rgName --enable-vm-config-agent true

Nächste Schritte

Wenn Probleme auftreten, lesen Sie die Behandlung von VMware-Migrationsproblemen.

Feedback

War diese Seite hilfreich?

Last updated on 2025-12-16