Visão geral do Azure Windows VM Agent

O Agente de VM do Windows do Microsoft Azure é um processo leve e seguro que gerencia a interação da máquina virtual (VM) com o controlador de malha do Azure. O Agente de VM do Windows do Azure tem uma função principal na habilitaçã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, você não pode executar extensões de VM.

Este artigo descreve como instalar e detetar o Azure Windows VM Agent.

Pré-requisitos

O Agente de VM do Windows Azure dá suporte à arquitetura x64 para estes sistemas operacionais Windows:

  • Windows 10
  • Windows 11
  • Windows Server 2008 SP2
  • Windows Server 2008 R2
  • Windows Server 2012
  • Windows Server 2012 R2
  • Windows Server 2016
  • Núcleo do Windows Server 2016
  • Windows Server 2019
  • Núcleo do Windows Server 2019
  • Windows Server 2022
  • Núcleo do Windows Server 2022

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. Consulte Suporte de versão mínima para agentes de máquina virtual no Azure.

  • Certifique-se de que sua VM tenha 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?.

  • Verifique se o DHCP está habilitado dentro da VM convidada. Isso é necessário para obter o endereço de host ou malha do DHCP para que o Agente de VM do Windows do Azure e as extensões funcionem. Se precisar de um endereço IP privado estático, você deve configurá-lo por meio do portal do Azure ou do PowerShell e verificar se a opção DHCP dentro da VM está habilitada. Saiba mais sobre como configurar um endereço IP estático usando o PowerShell.

  • A execução do Agente de VM do Windows do Azure em uma VM de virtualização aninhada pode levar a um comportamento imprevisível, portanto, não há suporte para ele 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 é instalado por padrão em qualquer VM do Windows implantada a partir de uma imagem do Azure Marketplace. Quando você implanta uma imagem do Azure Marketplace a partir do portal do Azure, do PowerShell, da CLI do Azure ou de um modelo do Azure Resource Manager, o Agente de VM do Windows do Azure também é instalado.

O pacote do Azure Windows VM Agent tem duas partes:

  • Azure Windows Provisioning Agent (PA)
  • Azure Windows Guest Agent (WinGA)

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

Instalação manual

Você pode instalar manualmente o Agente de VM do Windows do Azure usando um pacote do Windows Installer. A instalação manual pode ser necessária quando você cria uma imagem de VM personalizada implantada no Azure.

Para instalar manualmente o Agente de VM do Windows do Azure, baixe o instalador e selecione a versão mais recente. Você também pode pesquisar 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 tem suporte no Windows Server 2008 (64 bits) e posterior.

Nota

  • Se uma VM foi criada a partir de uma imagem personalizada ou do Marketplace sem ProvisionVMAgent habilitada, é importante atualizar a AllowExtensionOperations para true depois de instalar manualmente o Agente de VM do Windows do Azure.
  • Isso NÃO é necessário se a VM foi criada a partir de um disco especializado. Por exemplo, se a VM foi criada diretamente de um disco existente.
$vm = Get-AzVM -Name <VM Name> -ResourceGroupName <Resource Group Name>
$vm.OSProfile.AllowExtensionOperations = $true
$vm | Update-AzVM

Detetar o Agente de VM do Windows do Azure

PowerShell

Você pode usar o módulo PowerShell do Azure Resource Manager para obter informações sobre VMs do Azure. Para ver informações sobre uma VM, como o estado de provisionamento do Agente de VM do Windows Azure, use Get-AzVM:

Get-AzVM

A saída de exemplo condensado a seguir mostra a propriedade aninhada dentro OSProfiledo ProvisionVMAgent . Você pode usar essa propriedade para determinar se o agente da VM foi implantado na VM.

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

Use o script a seguir para retornar uma lista concisa de nomes de VM (executando o sistema operacional 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
}

Use o script a seguir para retornar uma lista concisa de nomes de VM (executando o sistema operacional Linux) 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 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 de VM do Windows do Azure, abra o Gerenciador de Tarefas, selecione a guia Detalhes e procure um processo chamado 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 implantadas do Azure Marketplace. As novas versões são armazenadas no Armazenamento do Azure, portanto, certifique-se de que você não tenha firewalls bloqueando 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 você instalou o agente manualmente ou está implantando imagens de VM personalizadas, precisará atualizar manualmente para incluir o novo agente de VM no momento da criação da imagem.

Coleta automática de logs do Azure Windows Guest Agent

O Agente Convidado do Windows do Azure tem um recurso para coletar automaticamente alguns logs. O processo CollectGuestLogs.exe controla esse recurso. Ele existe tanto para serviços de nuvem de plataforma como serviço (PaaS) quanto para VMs de infraestrutura como serviço (IaaS). Seu objetivo é coletar rápida e automaticamente logs de diagnóstico de uma VM, para que possam ser usados para análise offline.

Os logs coletados são logs de eventos, logs do sistema operacional, logs do Azure e algumas chaves do Registro. O agente produz um arquivo ZIP que é transferido para o host da VM. As equipes de engenharia e os profissionais de suporte podem usar esse arquivo ZIP para investigar problemas a pedido do cliente proprietário da VM.

Azure Windows Guest Agent e certificados OSProfile

O Agente de VM do Windows do Azure instala os certificados referenciados no OSProfile valor de uma VM ou de um conjunto de dimensionamento de máquina virtual. Se você remover manualmente esses certificados do snap-in Certificados do Console de Gerenciamento Microsoft (MMC) dentro da VM convidada, o Agente Convidado do Windows do Azure os adicionará novamente. Para remover permanentemente um certificado, tem de removê-lo do e, em OSProfileseguida, removê-lo do sistema operativo convidado.

Para uma máquina virtual, use Remove-AzVMSecret para remover certificados do OSProfile.

Para obter mais informações sobre certificados para conjuntos de dimensionamento de máquina virtual, consulte Conjuntos de escala de máquina virtual do Azure - Como remover certificados preteridos?.

Próximos passos

Para obter mais informações sobre extensões de VM, consulte Extensões e recursos de máquina virtual do Azure.