Installare l'agente di macchine virtuali Azure in modalità offline

L'agente di macchine virtuali Azure (agente di macchine virtuali) offre funzionalità utili, ad esempio la reimpostazione della password dell'amministratore locale e il push di script. Questo articolo illustra come installare l'agente di macchine virtuali per una macchina virtuale (VM) Windows offline.

Quando utilizzare l'agente di macchine virtuali in modalità offline

Installare l'Agente di macchine virtuali in modalità offline se quest'ultimo non è installato e non è possibile eseguire l'accesso tramite RDP alla macchina virtuale.

Se puoi eseguire l'accesso tramite RDP alla macchina virtuale, è sufficiente scaricare e installare l'Agente di macchine virtuali manualmente.

Come installare l'agente di macchine virtuali in modalità offline

Utilizzare i passaggi seguenti per installare l'agente di macchine virtuali in modalità offline.

Passaggio 1: collegare il disco del sistema operativo della macchina virtuale a un'altra macchina virtuale come disco dati

  1. Acquisisci uno snapshot per il disco del sistema operativo della macchina virtuale interessata, crea un disco dallo snapshot e quindi collega il disco a una macchina virtuale per la risoluzione dei problemi. Per altre informazioni, vedere Risolvere i problemi di una macchina virtuale Windows collegando il disco del sistema operativo a una macchina virtuale di ripristino tramite il portale di Azure. Per la macchina virtuale classica, eliminare la macchina virtuale e mantenere il disco del sistema operativo, quindi collegare il disco del sistema operativo alla macchina virtuale per la risoluzione dei problemi.

  2. Connettiti alla VM dello strumento di risoluzione dei problemi. Apri Gestione computer>Gestione disco. Verificare che il disco del sistema operativo sia online e che le lettere di unità siano assegnate alle partizioni del disco.

Passaggio 2: modificare il disco del sistema operativo per installare l'agente di macchine virtuali Azure

  1. Effettuare una connessione desktop remoto alla VM dello strumento di risoluzione dei problemi.

  2. Nella macchina virtuale per la risoluzione dei problemi, passare al disco del sistema operativo collegato, quindi aprire la cartella windows\system32\config. Copia tutti i file in questa cartella come backup, nel caso sia necessario un rollback.

  3. Avviare Editor del Registro di sistema (regedit.exe).

  4. Seleziona la chiave HKEY_LOCAL_MACHINE. Nel menu, seleziona File>Carica Hive:

                  Screenshot della chiave HKEY_LOCAL_MACHINE e dell'opzione Carica Hive nel menu File nell'Editor del Registro di sistema.                            

  5. Passare alla cartella \windows\system32\config\SYSTEM sul disco del sistema operativo collegato. Per il nome dell'hive, inserisci BROKENSYSTEM. Il nuovo hive del registro viene visualizzato sotto la chiave HKEY_LOCAL_MACHINE.

  6. Se sul disco del sistema operativo collegato è installato l'Agente di macchine virtuali, eseguire un backup della configurazione corrente. Se Agente di macchine virtuali non è installato, passare al passaggio successivo.

    1. Rinominare la cartella \windowsazure in \windowsazure.old.

    2. Esporta i seguenti registri:

      • HKEY_LOCAL_MACHINE\BROKENSYSTEM\ControlSet001\Services\WindowsAzureGuestAgent
      • HKEY_LOCAL_MACHINE\BROKENSYSTEM\ControlSet001\Servizi\RdAgent
  7. Utilizzare i file esistenti nella macchina virtuale dello strumento di risoluzione dei problemi come repository per l'installazione dell'agente di macchine virtuali. Completare i passaggi seguenti:

    1. Dalla macchina virtuale per la risoluzione dei problemi, esportare le seguenti sottochiavi in formato del registro (.reg):

      •               HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\WindowsAzureGuestAgent

      •               HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\RdAgent

                      Screenshot dei file di registro rdagent e winazureguestagent in Esplora risorse.                            

    2. Modifica i file di registro. In ogni file, modifica il valore della voce SYSTEM in BROKENSYSTEM (come mostrato nelle immagini seguenti) e salva il file. Ricorda l'ImagePath dell'attuale agente di macchine virtuali. Dovremo copiare la cartella corrispondente sul disco del sistema operativo collegato.

                    Screenshot del valore della voce originale e del valore della voce modificato del file rdagent reg.                            

    3. Importare i file di registro nel repository facendo doppio clic su ciascun file di registro.

    4. Verificare che le seguenti sottochiavi siano importate correttamente nell'hive BROKENSYSTEM:

      • WindowsAzureGuestAgent
      • RdAgent
    5. Copia la cartella di installazione dell'attuale agente di macchine virtuali sul disco del sistema operativo collegato:

      1. Nel disco del sistema operativo collegato, creare una cartella denominata WindowsAzure nel percorso radice.

      2. Passare a C:\WindowsAzure sulla macchina virtuale per la risoluzione dei problemi e cercare una cartella denominata C:\WindowsAzure\GuestAgent_X.X.XXXX.XXX. Copiare la cartella GuestAgent con il numero di versione più recente da C:\WindowsAzure alla cartella WindowsAzure nel disco del sistema operativo collegato. Se non si è sicuri di quale cartella copiare, copiare tutte le cartelle GuestAgent. L'immagine seguente mostra un esempio della cartella GuestAgent copiata sul disco del sistema operativo collegato. Se non si riesce a trovare la cartella GuestAgent, controllare il percorso dell'immagine della sottochiave del Registro di sistema WindowsAzureGuestAgent per ottenere il percorso corretto.

                      Screenshot di una cartella GuestAgent di esempio nel disco del sistema operativo collegato.                            

  8. Seleziona BROKENSYSTEM. Dal menu, seleziona File>Scarica Hive.

  9. Scollega il disco del sistema operativo, quindi modifica il disco del sistema operativo per la VM interessata. Per la VM classica, crea una nuova VM usando il disco del sistema operativo riparato.

  10. Accedi alla VM. Si noti che RdAgent è in esecuzione e che i log vengono generati.

Se hai creato la macchina virtuale usando il modello di distribuzione di Resource Manager, hai finito.

Usare la proprietà ProvisionGuestAgent per le macchine virtuali classiche

Importante

Le macchine virtuali classiche verranno ritirate il 1° settembre 2023

Se si utilizzano risorse IaaS da ASM, completare la migrazione entro il 1° settembre 2023. Ti invitiamo a effettuare il passaggio prima per sfruttare i numerosi miglioramenti delle funzionalità in Azure Resource Manager.

Per ulteriori informazioni, consultare Migrazione delle risorse IaaS in Azure Resource Manager entro il 1° settembre 2023.

Se hai creato la macchina virtuale usando il modello classico, usa il modulo di Azure PowerShell per aggiornare la proprietà ProvisionGuestAgent. La proprietà informa Azure che nella macchina virtuale è installato l'agente di macchine virtuali.

Per impostare la proprietà ProvisionGuestAgent, esegui i comandi seguenti in Azure PowerShell:

$vm = Get-AzureVM –ServiceName <cloud service name> –Name <VM name>
$vm.VM.ProvisionGuestAgent = $true
Update-AzureVM –Name <VM name> –VM $vm.VM –ServiceName <cloud service name>

Quindi eseguire il comando Get-AzureVM. Si noti che la proprietà GuestAgentStatus è ora popolata con i dati:

Get-AzureVM –ServiceName <cloud service name> –Name <VM name>
GuestAgentStatus:Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus

Passaggi successivi

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.