Información general sobre el agente de VM Windows de Azure

El agente de VM Windows de Microsoft Azure es un proceso ligero y seguro que administra la interacción de las máquinas virtuales (VM) con el controlador de tejido de Azure. El agente de VM Windows de Azure tiene un rol principal que consiste en habilitar y ejecutar extensiones de máquina virtual de Azure. Las extensiones de VM habilitan la configuración posterior a la implementación de VM, como la instalación y la configuración de software. Las extensiones de máquina virtual también habilitan características de recuperación, como el restablecimiento de la contraseña administrativa de una máquina virtual. Sin el agente de VM Windows de Azure, no se pueden ejecutar extensiones de máquina virtual.

En este artículo se describe cómo instalar y detectar el agente de VM Windows de Azure.

Requisitos previos

El agente de VM Windows de Azure admite la arquitectura x64 para estos 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

Instalación del agente de VM Windows de Azure

Imagen de Azure Marketplace

El agente de VM Windows de Azure se instala de manera predeterminada en cualquier máquina virtual Windows implementada a partir de una imagen de Azure Marketplace. Al implementar una imagen de Azure Marketplace desde Azure Portal, PowerShell, la CLI de Azure o una plantilla de Azure Resource Manager, también se instala el agente de VM Windows de Azure.

El paquete del agente de VM Windows de Azure tiene dos partes:

• El agente de aprovisionamiento (PA) de Windows de Azure
• El agente invitado de Windows (WinGA) de Azure

Para iniciar una máquina virtual, debe tener instalado el PA en la máquina virtual. Sin embargo, no es necesario que el WinGA esté instalado. En tiempo de implementación de la máquina virtual, puede seleccionar no instalar WinGA. En el ejemplo siguiente se muestra cómo seleccionar la opción provisionVmAgent con una plantilla de 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"
				}
			}
		}
	}]
}

Si no tiene instalados los agentes, no puede usar algunos servicios de Azure, como Azure Backup o Azure Security. Estos servicios requieren una extensión para instalarse. Si implementa una máquina virtual sin el WinGA, puede instalar más tarde la versión más reciente del agente.

Instalación manual

Puede instalar manualmente el agente de VM Windows de Azure mediante un paquete de Windows Installer. Es posible que sea necesaria la instalación manual cuando se crea una imagen de máquina virtual personalizada que se implementa en Azure.

Para instalar manualmente el agente de VM Windows de Azure, descargue el instalador y seleccione la versión más reciente. También puede buscar una versión específica en la página de GitHub de versiones del agente de VM Windows de Azure. El agente de VM Windows de Azure se admite en Windows Server 2008 (64 bits) y versiones posteriores.

$vm = Get-AzVM -Name <VM Name> -ResourceGroupName <Resource Group Name>
$vm.OSProfile.AllowExtensionOperations = $true
$vm | Update-AzVM

Detección del agente de VM Windows de Azure

PowerShell

Puede usar el módulo de PowerShell de Azure Resource Manager para obtener información sobre máquinas virtuales de Azure. Para ver información sobre una VM, como el estado de aprovisionamiento del agente de VM Windows de Azure, use Get-AzVM:

Get-AzVM

El siguiente ejemplo condensado de salida muestra la propiedad ProvisionVMAgentProvisionVMAgent anidada dentro de ProvisionVMAgent. Puede usar esta propiedad usar para determinar si el agente de VM se ha implementado en la VM.

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

Use el siguiente script para devolver una lista concisa de nombres de máquinas virtuales (con el sistema operativo Windows) y el estado del agente de VM Windows de 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 el siguiente script para devolver una lista concisa de nombres de máquinas virtuales (con el sistema operativo Linux) y el estado del agente de VM Windows de Azure:

$vms = Get-AzVM

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

Detección manual

Cuando inicia sesión en una máquina virtual Windows, puede usar el Administrador de tareas para examinar los procesos en ejecución. Para comprobar el agente de VM Windows de Azure, abra el Administrador de tareas, seleccione la pestaña Detalles y busque el proceso denominado WindowsAzureGuestAgent.exe. La presencia de este proceso indica que el agente de VM está instalado.

Actualización del agente de VM Windows de Azure

El agente de VM Windows de Azure para Windows se actualiza automáticamente en las imágenes implementadas desde Azure Marketplace. Las nuevas versiones se almacenan en Azure Storage, por lo que debe asegurarse de que no haya firewalls que bloqueen el acceso. A medida que se implementan nuevas máquinas virtuales en Azure, reciben el agente de máquina virtual más reciente en tiempo de aprovisionamiento de máquina virtual. Si ha instalado el agente manualmente o está implementando imágenes de VM personalizadas, debe realizar la actualización manualmente para incluir el nuevo agente de VM en el momento de creación de la imagen.

Recopilación automática de registros del agente invitado de Windows de Azure

El agente invitado de Windows de Azure tiene una característica para recopilar automáticamente algunos registros. El proceso CollectGuestLogs.exe controla esta característica. Existe tanto para los servicios en la nube de plataforma como servicio (PaaS) como para las máquinas virtuales de infraestructura como servicio (IaaS). Su objetivo es recopilar registros de diagnóstico de forma rápida y automática de una máquina virtual a fin de poder usarlos para los análisis sin conexión.

Los registros recopilados son registros de eventos, registros del sistema operativo, registros de Azure y algunas claves del Registro. El agente genera un archivo ZIP que se transfiere al host de la máquina virtual. Los equipos de ingeniería y los profesionales de soporte técnico pueden usar este archivo ZIP para investigar problemas en la solicitud del cliente propietario de la máquina virtual.

Certificados del agente invitado de Windows de Azure y OSProfile

El agente de VM Windows de Azure instala los certificados a los que se hace referencia en el valor de OSProfile de una máquina virtual o un conjunto de escalado de máquinas virtuales. Si quita manualmente estos certificados del complemento Certificados de Microsoft Management Console (MMC) dentro de la máquina virtual invitada, el agente invitado de Windows de Azure los agregará de nuevo. Para eliminar un certificado de forma permanente, tiene que quitarlo de OSProfile y, luego, quitarlo del sistema operativo invitado.

En el caso de una máquina virtual, use Remove-AzVMSecret para quitar certificados de OSProfile.

Para obtener más información sobre los certificados de conjuntos de escalado de máquinas virtuales, consulte Azure Virtual Machine Scale Sets: ¿Cómo se quitan los certificados en desuso?.

Pasos siguientes

Para más información sobre las extensiones de máquina virtual, consulte Características y extensiones de las máquinas virtuales de Azure.