Descrição geral do Agente de VM do Windows do Azure

  • Artigo

O Agente de VM do Windows do Microsoft Azure é um processo simples e seguro que gere a interação da máquina virtual (VM) com o controlador de recursos de infraestrutura do Azure. O Agente de VM do Windows do Azure tem uma função principal na ativação e execução de extensões de máquina virtual do Azure. As extensões de VM permitem a configuração pós-implementação de VMs, como instalar e configurar o software. As extensões de VM também permitem funcionalidades de recuperação, como a reposição da palavra-passe administrativa de uma VM. Sem o Agente de VM do Windows do Azure, não pode executar extensões de VM.

Este artigo descreve como instalar e detetar o Agente de VM do Windows do Azure.

Pré-requisitos

O Agente de VM do Windows do Azure suporta a arquitetura x64 para estes sistemas operativos 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

  • O Agente de VM do Windows do Azure precisa de, pelo menos, o Windows Server 2008 SP2 (64 bits) para ser executado, com o .NET Framework 4.0. Veja Suporte de versão mínima para agentes de máquinas virtuais no Azure.

  • Certifique-se de que a VM tem acesso ao endereço IP 168.63.129.16. Para obter mais informações, consulte O que é o endereço IP 168.63.129.16?.

  • Certifique-se de que o DHCP está ativado dentro da VM convidada. Isto é necessário para que o endereço do anfitrião ou dos recursos de infraestrutura do DHCP para o Agente da VM do Windows do Azure e as extensões funcionem. Se precisar de um endereço IP privado estático, deve configurá-lo através do portal do Azure ou do PowerShell e certificar-se de que a opção DHCP dentro da VM está ativada. Saiba mais sobre como configurar um endereço IP estático com o PowerShell.

  • Executar o Agente de VM do Windows do Azure numa VM de virtualização aninhada pode levar a um comportamento imprevisível, pelo que não é suportado nesse cenário de desenvolvimento/teste.

Instalar o Agente de VM do Windows do Azure

Imagem do Azure Marketplace

O Agente de VM do Windows do Azure está instalado por predefinição em qualquer VM do Windows implementada a partir de uma imagem de Azure Marketplace. Quando implementa uma imagem de Azure Marketplace a partir do portal do Azure, do PowerShell, da CLI do Azure ou de um modelo de Resource Manager do Azure, o Agente de VM do Windows do Azure também é instalado.

O pacote do Agente da VM do Windows do Azure tem duas partes:

  • Agente de Aprovisionamento do Windows do Azure (PA)
  • Agente Convidado do Windows do Azure (WinGA)

Para iniciar uma VM, tem de ter o PA instalado na VM. No entanto, o WinGA não precisa de ser instalado. Na altura da implementação da VM, pode selecionar não instalar o WinGA. O exemplo seguinte mostra como selecionar a opção provisionVmAgent com um modelo do 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 não tiver os agentes instalados, não poderá utilizar alguns serviços do Azure, como o Azure Backup ou a Segurança do Azure. Estes serviços precisam de uma extensão para serem instalados. Se implementar uma VM sem o WinGA, pode instalar a versão mais recente do agente mais tarde.

Instalação manual

Pode instalar manualmente o Agente de VM do Windows do Azure com um pacote do Windows Installer. A instalação manual poderá ser necessária quando cria uma imagem de VM personalizada implementada no Azure.

Para instalar manualmente o Agente de VM do Windows do Azure, transfira o instalador e selecione a versão mais recente. Também pode procurar uma versão específica na página do GitHub para versões do Agente de VM do Windows do Azure. O Agente de VM do Windows do Azure é suportado no Windows Server 2008 (64 bits) e posterior.

Nota

É importante atualizar a opção AllowExtensionOperations depois de instalar manualmente o Agente da VM do Windows do Azure numa VM que foi implementada a partir da imagem sem ProvisionVMAgent estar ativada.

$vm.OSProfile.AllowExtensionOperations = $true
$vm | Update-AzVM

Detetar o Agente de VM do Windows do Azure

PowerShell

Pode utilizar o módulo Azure Resource Manager PowerShell para obter informações sobre as VMs do Azure. Para ver informações sobre uma VM, como o estado de aprovisionamento do Agente de VM do Windows do Azure, utilize Get-AzVM:

Get-AzVM

O seguinte resultado de exemplo condensado mostra a ProvisionVMAgent propriedade aninhada dentro OSProfilede . Pode utilizar esta propriedade para determinar se o agente da VM foi implementado na VM.

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

Utilize o seguinte script para devolver uma lista concisa de nomes de VMs (com o SO Windows) e o estado do Agente de VM do Windows do Azure:

$vms = Get-AzVM

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

Utilize o seguinte script para devolver uma lista concisa de nomes de VMs (a executar o SO Linux) e o estado do Agente da VM do Windows do Azure:

$vms = Get-AzVM

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

Deteção manual

Quando tiver sessão iniciada numa VM do Windows, pode utilizar o Gestor de Tarefas para examinar os processos em execução. Para verificar o Agente da VM do Windows do Azure, abra o Gestor de Tarefas , selecione o separador Detalhes e procure um processo com o nome WindowsAzureGuestAgent.exe. A presença deste processo indica que o agente da VM está instalado.

Atualizar o Agente de VM do Windows do Azure

O Agente de VM do Windows do Azure para Windows é atualizado automaticamente em imagens implementadas a partir de Azure Marketplace. As novas versões são armazenadas no Armazenamento do Azure, por isso certifique-se de que não tem firewalls a bloquear o acesso. À medida que as novas VMs são implementadas no Azure, recebem o agente da VM mais recente no momento do aprovisionamento da VM. Se instalou o agente manualmente ou está a implementar imagens de VM personalizadas, terá de atualizar manualmente para incluir o novo agente da VM no momento da criação da imagem.

Recolha automática de registos do Agente Convidado do Windows do Azure

O Agente Convidado do Windows do Azure tem uma funcionalidade para recolher automaticamente alguns registos. O processo deCollectGuestLogs.exe controla esta funcionalidade. Existe para serviços cloud de plataforma como serviço (PaaS) e VMs de infraestrutura como serviço (IaaS). O objetivo é recolher registos de diagnósticos de uma VM de forma rápida e automática, para que possam ser utilizados para análise offline.

Os registos recolhidos são registos de eventos, registos do SO, registos do Azure e algumas chaves de registo. O agente produz um ficheiro ZIP que é transferido para o anfitrião da VM. As equipas de engenharia e os profissionais de suporte podem então utilizar este ficheiro ZIP para investigar problemas a pedido do cliente proprietário da VM.

Agente Convidado do Azure Windows e certificados OSProfile

O Agente da VM do Windows do Azure instala os certificados referenciados no OSProfile valor de uma VM ou de um conjunto de dimensionamento de máquinas virtuais. Se remover manualmente estes certificados do snap-in Certificados da Consola de Gestão da Microsoft (MMC) dentro da VM convidada, o Agente Convidado do Windows do Azure irá adicioná-los novamente. Para remover permanentemente um certificado, tem de removê-lo do OSProfilee, em seguida, removê-lo do sistema operativo convidado.

Para uma máquina virtual, utilize Remove-AzVMSecret para remover certificados de OSProfile.

Para obter mais informações sobre certificados para conjuntos de dimensionamento de máquinas virtuais, veja Azure Conjuntos de Dimensionamento de Máquinas Virtuais - Como devo proceder para remover certificados preteridos?.

Passos seguintes

Para obter mais informações sobre extensões de VM, veja Extensões e funcionalidades de máquinas virtuais do Azure.