Documentación de productos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Supervisión y solución de problemas

March 25, 2026
Contribución de: 
C C

Supervisar las actualizaciones programadas de VDA

Los VDA y los catálogos de máquinas tienen dos atributos que te ayudan a supervisar la preparación y el estado actual de las actualizaciones de VDA. Estos atributos son visibles como columnas que puedes usar para filtrar en Studio o en el panel de detalles de los VDA o catálogos.

  • Actualización de VDA
  • Estado de actualización de VDA

Actualización de VDA

Actualización de VDA proporciona información sobre si el VDA o el catálogo de máquinas tienen el agente de actualización de VDA configurado y si los VDA están actualizados o si hay una actualización disponible. Los estados disponibles son los siguientes:

Actualización de VDA (Studio) Actualización de VDA (PowerShell) Descripción
Nivel de catálogo
No configurado MissingUpgradeType No se ha seleccionado una ruta de actualización (CR, LTSR, CR EAR o LTSR EAR) para el catálogo de máquinas.
Programada UpgradeScheduled Hay una actualización programada para el catálogo de máquinas.
Disponible UpgradeAvailable Los VDA del catálogo no están en la última versión de la ruta de actualización. Se recomienda una actualización.
Actualizado UpToDate Los VDA del catálogo están en la última versión de la ruta de actualización. No se requiere ninguna acción.
Desconocido Unknown Recuperando el último estado de actualización de VDA.
Nivel de máquina
No configurado MissingUpgradeType No se ha seleccionado una ruta de actualización (CR, LTSR, CR EAR o LTSR EAR) para el catálogo de máquinas del VDA.
Programada UpgradeScheduled Hay una actualización programada para el VDA.
Disponible UpgradeAvailable El VDA no está en la última versión de la ruta de actualización. Se recomienda una actualización.
Actualizado UpToDate El VDA está en la última versión de la ruta de actualización. No se requiere ninguna acción.
Comprobando estado Unknown Recuperando el último estado de actualización de VDA.

Nota:

Para los VDA que usan la ruta LTSR, un catálogo solo se mostrará como Actualizado si los VDA están en la última actualización acumulativa (CU) de la última versión de servicio a largo plazo (LTSR). Si el VDA está en la última CU de una versión LTSR anterior, la Actualización de VDA seguirá mostrándose como Disponible.

Estado de actualización de VDA

Estado de actualización de VDA proporciona información sobre el estado de una actualización programada. Los estados de Estado de actualización de VDA son los siguientes:

Estado de actualización de VDA (Studio) Estado de actualización de VDA (PowerShell) Descripción
Nivel de catálogo
No programada NotScheduled No hay ninguna actualización programada para el catálogo.
Programada UpgradeScheduled Hay una actualización programada para el catálogo.
En curso UpgradeInProgress Hay una actualización en curso para el catálogo.
Cancelada UpgradeCancelled Se canceló una actualización para el catálogo. Esto puede deberse a una cancelación manual o a que se alcanzó el umbral de error.
Fallida UpgradeFailed Una actualización programada para el catálogo falló.
Correcta UpgradeSuccessful Una actualización programada para el catálogo se completó correctamente. Nota: Una actualización correcta no significa que todos los VDA del catálogo se actualizaron correctamente.
- Empty No hay ninguna actualización programada para el catálogo.
Nivel de máquina
Programada UpgradeScheduled Hay una actualización programada para el VDA.
Esperando actualización UpgradeInUpgradeWindow Hay una actualización programada activa, pero el VDA aún no ha comenzado a actualizarse. Consulta “Simultaneidad” para obtener más información sobre cómo se equilibran las cargas de las actualizaciones de VDA.
En curso UpgradeInProgress El VDA se está actualizando actualmente.
Cancelada UpgradeCancelled Se canceló una actualización programada para el VDA antes de que comenzara la actualización.
Actualización fallida UpgradeFailed El VDA comenzó a actualizarse, pero la actualización no se completó correctamente. Consulta “Solución de problemas” para obtener más información.
Correcta UpgradeSuccess El VDA se actualizó correctamente.
Validación fallida UpgradeValidationFailed La validación del certificado falló al descargar los metadatos para el instalador de VDA.
- Empty No hay ninguna actualización programada para el VDA.

Solución de problemas de actualizaciones programadas de VDA

Si encuentras errores de actualización, los siguientes registros pueden ayudarte a identificar y solucionar los problemas. También puedes compartir estos registros con el Soporte técnico de Citrix para acelerar el proceso de asistencia.

Registros de instalación de VDA

Al solucionar problemas de errores de actualización, recopila y revisa los registros tanto de la instalación inicial del VDA como de la actualización fallida. Los registros de instalación y actualización se pueden encontrar en las siguientes ubicaciones.

  • Los registros de instalación para las instalaciones de VDA se encuentran en:
    • %temp%/Citrix/XenDesktop Installer
  • Los registros de actualización para las instalaciones de VDA se encuentran en:
    • C:\Windows\Temp\Citrix\XenDesktop Installer o
    • C:\Windows\SystemTemp\Citrix\XenDesktop Installer

Versión del agente de actualización de VDA

Al recopilar datos para solucionar problemas de errores de actualización a través de VUS, es importante conocer la versión del agente de actualización en los VDA. Para comprobar las versiones del agente de actualización de VDA, usa el siguiente cmdlet: Get-VusComponentVersion -ComponentType VUS. Este cmdlet enumera todos los VDA y sus versiones del agente de actualización de VDA.

Para comprobar las versiones del agente de actualización de VDA a nivel de catálogo, puedes usar el siguiente script:

Nota:

El script está pensado como un ejemplo y podría necesitar adaptarse a tu entorno específico. Te recomendamos que pruebes el script a fondo antes de usarlo en un entorno de producción.

Param( [Parameter (Mandatory=$true)] [string] $CatalogName ) try { $Uuids = Get-BrokerMachine -CatalogName $CatalogName | Select-Object -Property UUID

if($Uuids -eq $null) { throw "Cannot find CatalogName " +$CatalogName } Write-Output("Catalog Name passed is "+$CatalogName)

foreach($Uuid in $Uuids) { $compVersion = Get-VusComponentVersion -MachineId $machine.UUID -ComponentType VUS $Machine = Get-BrokerMachine -UUID $compVersion.MachineId Write-Output(“MachineName: “+$Machine.MachineName+”, Machine UUID:”+$machine.MachineId+”, VUA Version:”+$compVersion.Version) } } catch { Write-Output(“Exception Occured”) Write-Host $_ }

Registros relacionados con el agente de actualización de VDA

Los registros del agente de actualización de VDA (VUA) pueden proporcionar información esencial para solucionar problemas de errores de actualización y problemas de comunicación del VUA con el servicio de actualización de VDA. Los registros que puedes recopilar incluyen:

  • Rastros de Citrix Diagnostic Facility (CDF). El nombre del módulo CDF es VdaUpgradeAgent.
  • Registros de eventos de Windows. Consulta los registros en Visor de eventos > Registros de Windows > Aplicaciones > Servicio de agente de actualización de Citrix VDA.

Hay una configuración de registro disponible que permite a los administradores habilitar un archivo de registro rotatorio que captura información crítica para la solución de problemas, al tiempo que evita que los archivos de registro crezcan demasiado. El tamaño total de los archivos de registro está limitado a 20 MB. Crea la siguiente clave de registro para habilitar el registro en un archivo:

  • Clave: HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile

  • Nombre del valor: LogToFile

  • Tipo de valor: REG_DWORD

  • Datos del valor:

    • 0 - rastreo de archivos deshabilitado

    • 1 - rastreo de archivos habilitado

Para crear la clave de registro LogToFile en un VDA mediante PowerShell, usa el siguiente cmdlet:

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile -Name LogToFile -Value 1 -PropertyType DWord -Force

Para habilitar LogToFile para grupos de máquinas a escala, considera crear el registro LogToFile en todas las unidades organizativas (OU) de VDA a través de la Preferencia de directiva de grupo.

Nota:

  • Cuando se establece LogToFile=1, los registros se escriben solo en el archivo. No aparecerán en los rastreos CDF.
  • Es necesario reiniciar el servicio del Agente de actualización de VDA para que el cambio de registro surta efecto.
  • El archivo de registro se crea en la carpeta C:\ProgramData\Citrix\Update Services\Logs.

Solucionar problemas de errores de descarga de la actualización de VDA

Sigue los pasos a continuación para solucionar y resolver los errores de descarga relacionados con la función de actualización de VDA:

  1. Asegúrate de que las URL relevantes se hayan agregado a la lista de permitidos si hay un filtrado de URL en vigor. Consulta Conectividad.

  2. Después de agregar las URL necesarias a la lista de permitidos, intenta reprogramar la actualización de VDA.

Puedes habilitar el rastreo CDF o establecer LogToFile en 1 para capturar registros detallados para el análisis. Si el problema de error de descarga persiste, comprueba los errores. Si ves el siguiente mensaje de error: “Download Failed: This access control list is not in canonical form and therefore cannot be modified”, indica que los permisos en la carpeta C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA son incorrectos.

Para solucionar el problema, haz una de las siguientes acciones:

  • Opción 1: Restablece las listas de control de acceso (ACL) en la carpeta usando el siguiente comando. (El comando restablece las ACL con las ACL heredadas predeterminadas para todos los archivos coincidentes).
    • icacls.exe “C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA” /reset /T /C /L /Q
  • Opción 2: Elimina la carpeta VDA en Descargas y luego programa la actualización de VDA.

Solucionar problemas de errores de validación de la actualización de VDA

Sigue los pasos a continuación para solucionar y resolver los errores de descarga relacionados con la función de actualización de VDA:

  1. Asegúrate de que las URL relevantes se hayan agregado a la lista de permitidos si hay un filtrado de URL en vigor, especialmente las URL de la Lista de revocación de certificados (CRL) o del Protocolo de estado de certificados en línea (OCSP) necesarias para la comprobación de revocación. Consulta Requisitos de actualización de VDA.

  2. Después de agregar las URL necesarias a la lista de permitidos, intenta reprogramar la actualización de VDA.

Sugerimos habilitar el rastreo CDF o establecer LogToFile en 1 para capturar registros detallados para el análisis. Los registros pueden incluir los siguientes errores:

  • RevocationStatusUnknown
  • La función de revocación no pudo comprobar el estado de revocación del certificado.
  • La función de revocación no pudo comprobar la revocación porque el servidor de revocación estaba sin conexión.

El Agente de actualización de VDA se basa en llamadas al sistema de Windows para validar certificados y realizar comprobaciones de revocación. Los errores anteriores indican que el agente no puede establecer una conexión con las URL de CRL u OCSP.

La CryptoAPI de Windows no admite actualmente la configuración de proxy. Revisa la sección VDAs con configuraciones de proxy para configurar tus proxies de VDA para facilitar las llamadas CRL salientes.

Supervisión y solución de problemas
March 25, 2026
Contribución de: 
C C
March 25, 2026
Contribución de: 
C C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.