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

November 25, 2025
Contribución de: 
C

Supervisión de actualizaciones de versión de VDA programadas

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

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

Actualización de versión de VDA

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

Actualización de versión de VDA (Studio) Actualización de versión de VDA (PowerShell) Descripción
Nivel de catálogo    
No configurado MissingUpgradeType No se ha seleccionado una opción de actualización (CR, LTSR, CR EAR o LTSR EAR) para el catálogo de máquinas.
Programado UpgradeScheduled Está prevista una actualización de versión para el catálogo de máquinas.
Disponible UpgradeAvailable Los VDA en el catálogo no tienen la versión más reciente de la opción de actualización elegida. Se recomienda actualizar la versión.
Actualizado UpToDate Los VDA del catálogo tienen la versión más reciente de la opción de actualización elegida. No se requiere ninguna acción.
Desconocido Desconocido Obteniendo el estado de actualización de versión de VDA más reciente.
Nivel de máquina    
No configurado MissingUpgradeType No se ha seleccionado una opción de actualización (CR, LTSR, CR EAR o LTSR EAR) para el catálogo de máquinas del VDA.
Programado UpgradeScheduled Está prevista una actualización de versión del VDA.
Disponible UpgradeAvailable El VDA no tiene la versión más reciente de la opción de actualización elegida. Se recomienda actualizar la versión.
Actualizado UpToDate El VDA tiene la versión más reciente de la opción de actualización elegida. No se requiere ninguna acción.
Comprobando estado Desconocido Obteniendo el estado de actualización de versión de VDA más reciente.

Nota:

Para los VDA que usan la opción LTSR, un catálogo solo se mostrará como Actualizado si los VDA tienen la actualización acumulativa (CU) más reciente de la versión Long Term Service Release (LTSR) más reciente. Si el VDA tiene la actualización CU más reciente de una versión LTSR anterior, la actualización de versión de VDA seguirá apareciendo como Disponible.

Estado de la actualización de versión de VDA

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

Estado de actualización de versión de VDA (Studio) Estado de actualización de versión de VDA (PowerShell) Descripción
Nivel de catálogo    
Sin programar NotScheduled No está prevista ninguna actualización de versión para el catálogo.
Programado UpgradeScheduled Está prevista una actualización de versión para el catálogo.
En curso UpgradeInProgress Hay una actualización de versión del catálogo en curso.
Cancelado UpgradeCancelled Se canceló una actualización de versión para el catálogo. Puede deberse a una cancelación manual o a que se alcanzó el umbral de fallo.
Error UpgradeFailed Falló una actualización de versión programada para el catálogo.
Correcto UpgradeSuccessful Se completó correctamente una actualización de versión programada para el catálogo. Nota: Una actualización correcta no significa que todos los VDA del catálogo se hayan actualizado correctamente.
- Vacío No hay ninguna programación de actualización prevista para el catálogo.
Nivel de máquina    
Programado UpgradeScheduled Está prevista una actualización de versión del VDA.
Esperando actualización UpgradeInUpgradeWindow Hay una actualización de versión programada activa, pero el VDA aún no ha comenzado a actualizarse. Consulte “Simultaneidad” para obtener más información sobre cómo se equilibran las cargas de actualización de versión de VDA.
En curso UpgradeInProgress El VDA se está actualizando actualmente.
Cancelado UpgradeCancelled Se canceló una actualización de versión programada para el VDA antes de que comenzara.
Actualización fallida UpgradeFailed El VDA comenzó a actualizarse pero el proceso no se completó correctamente. Para obtener más información, consulte “Solución de problemas”.
Correcto UpgradeSuccess La versión de VDA se actualizó correctamente.
Validación fallida UpgradeValidationFailed La validación del certificado falló al descargar los metadatos para el instalador de VDA.
- Vacío No hay ninguna actualización de versión prevista para el VDA.

Solución de problemas de actualizaciones de versión de VDA programadas

Si observa errores de actualización, los siguientes registros pueden ayudarle a identificar y solucionar los problemas. También puede compartir estos registros con la asistencia técnica de Citrix para agilizar el proceso de asistencia.

Registros de instalación de VDA

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

  • Los registros de la instalación de VDA se colocan en:
    • %temp%/Citrix/XenDesktop Installer
  • Los registros de actualización de versión de VDA se colocan en:
    • C:\Windows\Temp\Citrix\XenDesktop Installer o
    • C:\Windows\SystemTemp\Citrix\XenDesktop Installer

Versión de VDA Upgrade Agent

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

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

Nota:

El script sirve de ejemplo y es posible que necesite adaptarlo a su entorno específico. Se recomienda probar exhaustivamente el script 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 "No se puede encontrar CatalogName " +$CatalogName } Write-Output("El nombre de catálogo transmitido es "+$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 versiones de VDA

Los registros de VDA Upgrade Agent (VUA) pueden proporcionar información esencial para solucionar problemas de actualización y con la comunicación de VUA con el servicio de actualización de versiones de VDA. Los registros que puede recopilar incluyen:

  • Rastreos de Citrix Diagnostic Facility (CDF). El nombre del módulo CDF es VdaUpgradeAgent.
  • Registros de eventos de Windows. Consulte los registros en el Visor de eventos > Registros de Windows > Aplicaciones > Citrix VDA Upgrade Agent Service.

Hay disponible un parámetro de Registro que permite a los administradores habilitar un archivo de registro rotativo, el cual captura información crítica para la resolución de problemas y, al mismo tiempo, evita que los archivos de registros crezcan demasiado. El tamaño total de los archivos de registros está limitado a 20 MB. Cree la siguiente clave de Registro para habilitar la captura de registros en un archivo:

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

  • Nombre del valor: LogToFile

  • Tipo de valor: REG_DWORD

  • Información del valor:

    • 0: Seguimiento de archivos inhabilitado

    • 1: Seguimiento de archivos habilitado

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

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

Para habilitar LogToFile a gran escala en grupos de máquinas, considere la posibilidad de crear LogToFile en todas las unidades organizativas (OU) de los VDA mediante Preferencias de directivas de grupo.

Nota:

Cuando se establece LogToFile=1, los registros se escriben solo en el archivo. No aparecerán en los rastros de CDF.

Solucionar errores de descarga en la actualización de versiones de VDA

Siga los pasos que se indican a continuación para solucionar problemas y errores de descarga relacionados con la función de actualización de versiones de VDA:

  1. Asegúrese de que se hayan agregado las URL relevantes a la lista de permitidos si se ha implementado el filtrado de URL. Consulte Conectividad.

  2. Tras agregar las URL necesarias a la lista de permitidos, pruebe a reprogramar la actualización de versiones de VDA.

Puede habilitar el rastreo de CDF o configurar LogToFile en 1 con el objetivo de capturar registros detallados para su análisis. Si el problema del error de descarga persiste, compruebe los errores. Si aparece el siguiente mensaje de error “Error en la descarga: Esta lista de control de acceso no está en formato canónico y, por lo tanto, no se puede modificar”, indica que los permisos en la carpeta C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA son incorrectos.

Para solucionar el problema, realice una de estas acciones:

  • Opción 1: Restablezca 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: Elimine la carpeta VDA en Descargas y, a continuación, programe la actualización de versión de VDA.

Solucionar errores de validación en la actualización de versiones de VDA

Siga los pasos que se indican a continuación para solucionar problemas y errores de descarga relacionados con la función de actualización de versiones de VDA:

  1. Asegúrese de agregar las URL pertinentes a la lista de permitidos si existe el filtrado de URL, 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 comprobar la revocación. Consulte el requisito de actualización de versión de VDA.

  2. Tras agregar las URL necesarias a la lista de permitidos, pruebe a reprogramar la actualización de versiones de VDA.

Sugerimos habilitar el rastreo de CDF o configurar LogToFile en 1 con el objetivo de capturar registros detallados para su análisis. Los registros pueden incluir estos 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 desconectado.

El agente de actualización de versiones de VDA recurre a las llamadas del sistema de Windows para validar certificados y comprobar revocaciones. Los errores anteriores indican que el agente no puede establecer una conexión con las URL de CRL u OCSP.

Actualmente, la herramienta CryptoAPI de Windows no admite parámetros de proxy. Revise la sección VDA con configuraciones de proxy para configurar sus proxies de VDA para facilitar las llamadas CRL salientes.

Supervisión y solución de problemas
November 25, 2025
Contribución de: 
C
November 25, 2025
Contribución de: 
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.