Condividi tramite

Panoramica dell'agente di macchine virtuali Windows di Azure

  • Articolo

L'agente di macchine virtuali Windows di Microsoft Azure è un processo sicuro e leggero che gestisce l'interazione delle macchine virtuali con il controller di infrastruttura di Azure. L'agente di macchine virtuali Windows di Azure ha un ruolo primario nell'abilitazione e nell'esecuzione di estensioni di macchina virtuale di Azure. Le estensioni macchina virtuale rendono possibile la configurazione post-distribuzione delle macchine virtuali, ad esempio l'installazione e la configurazione di software. Le estensioni macchina virtuale abilitano anche funzionalità di ripristino, ad esempio la reimpostazione della password amministrativa di una macchina virtuale. Senza l'agente di macchine virtuali Windows di Azure, non è possibile eseguire le estensioni della macchina virtuale.

Questo articolo descrive come installare e rilevare l'agente di macchine virtuali Windows di Azure.

Prerequisiti

L'agente di macchine virtuali Windows di Azure supporta l'architettura x64 per questi sistemi operativi Windows:

  • Windows 10
  • Windows 11
  • Windows Server 2008 SP2
  • Windows Server 2008 R2
  • Windows Server 2012
  • Windows Server 2012 R2
  • Windows Server 2016
  • Windows Server 2016 Core
  • Windows Server 2019
  • Windows Server 2019 Core
  • Windows Server 2022
  • Windows Server 2022 Core

Importante

  • Per l'esecuzione dell'agente di macchine virtuali Windows di Azure è necessario almeno Windows Server 2008 SP2 (64 bit), con .NET Framework 4.0. Vedere Supporto della versione minima per gli agenti di macchine virtuali in Azure.

  • Assicurarsi che la macchina virtuale abbia accesso all'indirizzo IP 168.63.129.16. Per ulteriori informazioni, vedere Che cos'è l'indirizzo IP 168.63.129.16?.

  • Assicurarsi che DHCP sia abilitato all'interno della macchina virtuale guest. È necessario per ottenere l'indirizzo dell'host o dell'infrastruttura da DHCP per il funzionamento dell'agente di macchine virtuali Windows di Azure e delle estensioni. Se è necessario un indirizzo IP privato statico, è necessario configurarlo tramite il portale di Azure o PowerShell e assicurarsi che l'opzione DHCP all'interno della macchina virtuale sia abilitata. Altre informazioni sulla configurazione di un indirizzo IP statico tramite PowerShell.

  • L'esecuzione dell'agente di macchine virtuali Windows di Azure in una macchina virtuale di virtualizzazione annidata potrebbe causare un comportamento imprevedibile, quindi non è supportato in tale scenario di sviluppo/test.

Installare l'agente di macchine virtuali Windows di Azure

Immagine di Azure Marketplace

L'agente di macchine virtuali Windows di Azure viene installato per impostazione predefinita in qualsiasi macchina virtuale Windows distribuita da un'immagine di Azure Marketplace. Quando si distribuisce un'immagine di Azure Marketplace dal portale di Azure, PowerShell, dall'interfaccia della riga di comando di Azure o da un modello di Azure Resource Manager, viene installato anche l'agente di macchine virtuali Windows di Azure.

Il pacchetto dell'agente di macchine virtuali Windows di Azure include due parti:

  • Agente di provisioning windows di Azure (PA)
  • Agente guest windows di Azure (WinGA)

Per avviare una macchina virtuale, è necessario che l'applicazione pa sia installata nella macchina virtuale. Tuttavia, non è necessario installare WinGA. In fase di distribuzione della macchina virtuale, è possibile scegliere di non installare il WinGA. L'esempio seguente illustra come selezionare l'opzione provisionVmAgent con un modello di Azure Resource Manager:

{
	"resources": [{
		"name": ["parameters('virtualMachineName')"],
		"type": "Microsoft.Compute/virtualMachines",
		"apiVersion": "2016-04-30-preview",
		"location": ["parameters('location')"],
		"dependsOn": ["[concat('Microsoft.Network/networkInterfaces/', parameters('networkInterfaceName'))]"],
		"properties": {
			"osProfile": {
				"computerName": ["parameters('virtualMachineName')"],
				"adminUsername": ["parameters('adminUsername')"],
				"adminPassword": ["parameters('adminPassword')"],
				"windowsConfiguration": {
					"provisionVmAgent": "false"
				}
			}
		}
	}]
}

Se gli agenti non sono installati, non è possibile usare alcuni servizi di Azure, ad esempio Backup di Azure o Sicurezza di Azure. Per questi servizi è necessario installare un'estensione. Se si distribuisce una macchina virtuale senza WinGA, è possibile installare la versione più recente dell'agente in un secondo momento.

Installazione manuale

È possibile installare manualmente l'agente di macchine virtuali Windows di Azure usando un pacchetto di Windows Installer. L'installazione manuale potrebbe essere necessaria quando si crea un'immagine di macchina virtuale personalizzata distribuita in Azure.

Per installare manualmente l'agente di macchine virtuali Windows di Azure, scaricare il programma di installazione e selezionare la versione più recente. È anche possibile cercare una versione specifica nella pagina GitHub per le versioni dell'agente di macchine virtuali Windows di Azure. L'agente di macchine virtuali Windows di Azure è supportato in Windows Server 2008 (64 bit) e versioni successive.

Nota

  • Se una macchina virtuale è stata creata da un'immagine personalizzata o del Marketplace senza ProvisionVMAgent abilitare, è importante aggiornare a AllowExtensionOperations true dopo aver installato manualmente l'agente di macchine virtuali Windows di Azure.
  • Questa operazione NON è necessaria se la macchina virtuale è stata creata da un disco specializzato. Ad esempio, se la macchina virtuale è stata creata direttamente da un disco esistente.
$vm = Get-AzVM -Name <VM Name> -ResourceGroupName <Resource Group Name>
$vm.OSProfile.AllowExtensionOperations = $true
$vm | Update-AzVM

Rilevare l'agente di macchine virtuali Windows di Azure

PowerShell

È possibile usare il modulo PowerShell di Azure Resource Manager per ottenere informazioni sulle macchine virtuali di Azure. Per visualizzare informazioni su una macchina virtuale, ad esempio lo stato di provisioning per l'agente di macchine virtuali Windows di Azure, usare Get-AzVM:

Get-AzVM

L'output di esempio condensato seguente mostra la ProvisionVMAgent proprietà annidata all'interno OSProfiledi . È possibile usare questa proprietà per determinare se l'agente di macchine virtuali è stato distribuito nella macchina virtuale.

OSProfile                  :
  ComputerName             : myVM
  AdminUsername            : myUserName
  WindowsConfiguration     :
    ProvisionVMAgent       : True
    EnableAutomaticUpdates : True

Usare lo script seguente per restituire un elenco conciso di nomi di vm (che eseguono il sistema operativo Windows) e lo stato dell'agente di macchine virtuali Windows di Azure:

$vms = Get-AzVM

foreach ($vm in $vms) {
    $agent = $vm | Select -ExpandProperty OSProfile | Select -ExpandProperty Windowsconfiguration | Select ProvisionVMAgent
    Write-Host $vm.Name $agent.ProvisionVMAgent
}

Usare lo script seguente per restituire un elenco conciso di nomi di vm (che eseguono il sistema operativo Linux) e lo stato dell'agente di macchine virtuali Windows di Azure:

$vms = Get-AzVM

foreach ($vm in $vms) {
    $agent = $vm | Select -ExpandProperty OSProfile | Select -ExpandProperty Linuxconfiguration | Select ProvisionVMAgent
    Write-Host $vm.Name $agent.ProvisionVMAgent
}

Rilevamento manuale

Quando si è connessi a una macchina virtuale Windows, è possibile usare Gestione attività per esaminare i processi in esecuzione. Per verificare la presenza dell'agente di macchine virtuali Windows di Azure, aprire Gestione attività, selezionare la scheda Dettagli e cercare un processo denominato WindowsAzureGuestAgent.exe. La presenza di questo processo indica che l'agente di macchine virtuali è installato.

Aggiornare l'agente di macchine virtuali Windows di Azure

L'agente di macchine virtuali Windows di Azure per Windows viene aggiornato automaticamente nelle immagini distribuite da Azure Marketplace. Le nuove versioni vengono archiviate in Archiviazione di Azure, quindi assicurarsi di non avere firewall che bloccano l'accesso. In quanto nuove macchine virtuali distribuite in Azure, ricevono la versione più recente dell'agente di macchine virtuali al momento del provisioning della macchina virtuale. Se l'agente è stato installato manualmente o si distribuiscono immagini di macchine virtuali personalizzate, è necessario aggiornare manualmente per includere il nuovo agente di macchine virtuali in fase di creazione dell'immagine.

Raccolta automatica dei log dell'agente guest windows di Azure

L'agente guest windows di Azure dispone di una funzionalità per raccogliere automaticamente alcuni log. Il processo CollectGuestLogs.exe controlla questa funzionalità. Esiste sia per le macchine virtuali paaS (Platform as a Service) che per le macchine virtuali IaaS (Infrastructure as a Service). L'obiettivo è quello di raccogliere rapidamente e automaticamente i log di diagnostica da una macchina virtuale, in modo che possano essere usati per l'analisi offline.

I log raccolti sono log eventi, log del sistema operativo, log di Azure e alcune chiavi del Registro di sistema. L'agente genera un file ZIP trasferito all'host della macchina virtuale. I team di progettazione e i professionisti del supporto possono quindi usare questo file ZIP per analizzare i problemi relativi alla richiesta del cliente proprietario della macchina virtuale.

Certificati osProfile e agente guest windows di Azure

L'agente di macchine virtuali Windows di Azure installa i certificati a cui si fa riferimento nel OSProfile valore di una macchina virtuale o di un set di scalabilità di macchine virtuali. Se questi certificati vengono rimossi manualmente dallo snap-in Microsoft Management Console (MMC) Certificates all'interno della macchina virtuale guest, l'agente guest di Azure li aggiungerà nuovamente. Per rimuovere definitivamente un certificato, è necessario rimuoverlo da OSProfilee quindi rimuoverlo dall'interno del sistema operativo guest.

Per una macchina virtuale, usare Remove-AzVMSecret per rimuovere i certificati da OSProfile.

Per altre informazioni sui certificati per i set di scalabilità di macchine virtuali, vedere Azure set di scalabilità di macchine virtuali - Ricerca per categorie rimuovere i certificati deprecati?.

Passaggi successivi

Per altre informazioni sulle estensioni delle macchine virtuali, vedere Estensioni e funzionalità delle macchine virtuali di Azure.