Citrix Virtual Apps and Desktops

Monitoramento e Solução de Problemas

January 23, 2026

Contribuição de:

Monitoramento de Atualizações Agendadas de VDA

Os VDAs e os catálogos de máquinas têm dois atributos que ajudam a monitorar a prontidão e o status atual das atualizações de VDA. Esses atributos são visíveis como colunas que podem ser usadas para filtrar no Studio ou no painel de detalhes dos VDAs ou catálogos.

Atualização de VDA
Estado da Atualização de VDA

Atualização de VDA

A Atualização de VDA fornece informações sobre se o VDA ou o catálogo de máquinas tem o agente de atualização de VDA configurado e se os VDAs estão atualizados ou se uma atualização está disponível. Os status disponíveis são os seguintes:

VDA Upgrade (Studio)	VDA Upgrade (Powershell)	Descrição
Nível do Catálogo
Not configured	MissingUpgradeType	Uma trilha de atualização (CR, LTSR, CR EAR ou LTSR EAR) não foi selecionada para o catálogo de máquinas.
Scheduled	UpgradeScheduled	Uma atualização está agendada para o catálogo de máquinas.
Available	UpgradeAvailable	Os VDAs no catálogo não estão na versão mais recente da trilha de atualização. Uma atualização é recomendada.
Up to date	UpToDate	Os VDAs no catálogo estão na versão mais recente da trilha de atualização. Nenhuma ação é necessária.
Unknown	Unknown	Recuperando o status mais recente da Atualização de VDA.
Nível da Máquina
Not configured	MissingUpgradeType	Uma trilha de atualização (CR, LTSR, CR EAR ou LTSR EAR) não foi selecionada para o catálogo de máquinas do VDA.
Scheduled	UpgradeScheduled	Uma atualização está agendada para o VDA.
Available	UpgradeAvailable	O VDA não está na versão mais recente da trilha de atualização. Uma atualização é recomendada.
Up to date	UpToDate	O VDA está na versão mais recente da trilha de atualização. Nenhuma ação é necessária.
Checking state	Unknown	Recuperando o status mais recente da Atualização de VDA.

Observação:

Para VDAs que usam a trilha LTSR, um catálogo só será exibido como “Up to date” se os VDAs estiverem na atualização cumulativa (CU) mais recente da versão de serviço de longo prazo (LTSR) mais recente. Se o VDA estiver na CU mais recente de uma versão LTSR anterior, a Atualização de VDA ainda será exibida como Available.

Estado da Atualização de VDA

O Estado da Atualização de VDA fornece informações sobre o status de uma atualização agendada. Os status do Estado da Atualização de VDA são os seguintes:

VDA Upgrade State (Studio)	VDA Upgrade State (PowerShell)	Descrição
Nível do Catálogo
Not scheduled	NotScheduled	Nenhuma atualização está agendada para o catálogo.
Scheduled	UpgradeScheduled	Uma atualização está agendada para o catálogo.
In progress	UpgradeInProgress	Uma atualização está em andamento para o catálogo.
Canceled	UpgradeCancelled	Uma atualização foi cancelada para o catálogo. Isso pode ocorrer devido a um cancelamento manual ou ao atingimento do limite de falhas.
Failed	UpgradeFailed	Uma atualização agendada para o catálogo falhou.
Successful	UpgradeSuccessful	Uma atualização agendada para o catálogo foi concluída com êxito. Observação: Uma atualização bem-sucedida não significa que todos os VDAs no catálogo foram atualizados com êxito.
-	Empty	Nenhuma atualização agendada para o catálogo.
Nível da Máquina
Scheduled	UpgradeScheduled	Uma atualização está agendada para o VDA.
Awaiting upgrade	UpgradeInUpgradeWindow	Uma atualização agendada está ativa, mas o VDA ainda não começou a ser atualizado. Consulte “Simultaneidade” para obter mais informações sobre como as atualizações de VDA são balanceadas por carga.
In progress	UpgradeInProgress	O VDA está sendo atualizado no momento.
Canceled	UpgradeCancelled	Uma atualização agendada foi cancelada para o VDA antes do início da atualização.
Upgrade failed	UpgradeFailed	O VDA começou a ser atualizado, mas a atualização não foi concluída com êxito. Consulte “Solução de problemas” para obter mais informações.
Succesful	UpgradeSuccess	O VDA foi atualizado com êxito.
Validation failed	UpgradeValidationFailed	A validação do certificado falhou durante o download dos metadados para o instalador do VDA.
-	Empty	Nenhuma atualização está agendada para o VDA.

Solução de Problemas de Atualizações Agendadas de VDA

Se você encontrar falhas de atualização, os logs a seguir podem ajudar a identificar e solucionar os problemas. Você também pode compartilhar esses logs com o Suporte Técnico da Citrix para agilizar o processo de assistência.

Logs de Instalação do VDA

Ao solucionar problemas de falhas de atualização, colete e revise os logs da instalação inicial do VDA e da atualização com falha. Os logs de instalação e atualização podem ser encontrados nos seguintes locais.

Os logs de instalação para instalações de VDA são colocados em:
- %temp%/Citrix/XenDesktop Installer
Os logs de atualização para instalações de VDA são colocados em:
- C:\Windows\Temp\Citrix\XenDesktop Installer ou
- C:\Windows\SystemTemp\Citrix\XenDesktop Installer

Versão do Agente de Atualização de VDA

Ao coletar dados para solucionar problemas de falhas de atualização por meio do VUS, é importante saber a versão do agente de atualização nos VDAs. Para verificar as versões do Agente de Atualização de VDA, use o seguinte cmdlet: Get-VusComponentVersion -ComponentType VUS. Ele lista todos os VDAs e suas versões do Agente de Atualização de VDA.

Para verificar as versões do Agente de Atualização de VDA no nível do catálogo, você pode usar o seguinte script:

Observação:

O script é fornecido como um exemplo e pode precisar ser adaptado para se adequar ao seu ambiente específico. Recomendamos que você teste o script completamente antes de usá-lo em um ambiente de produção.

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 $_ }

Logs relacionados ao Agente de Atualização de VDA

Os logs do Agente de Atualização de VDA (VUA) podem fornecer informações essenciais para solucionar falhas de atualização e problemas de comunicação do VUA com o serviço de atualização de VDA. Os logs que você pode coletar incluem:

Rastreamentos do Citrix Diagnostic Facility (CDF). O nome do módulo CDF é VdaUpgradeAgent.
Logs de eventos do Windows. Visualize os logs em “Visualizador de Eventos” > “Logs do Windows” > “Aplicativos” > “Serviço do Agente de Atualização de VDA da Citrix”.

Uma configuração de registro está disponível que permite aos administradores habilitar um arquivo de log rotativo que captura informações críticas para a solução de problemas, evitando que os arquivos de log cresçam demais. O tamanho total dos arquivos de log é limitado a 20 MB. Crie a seguinte chave de registro para habilitar o registro em um arquivo:

Chave: HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile
Nome do valor: LogToFile
Tipo de valor: REG_DWORD
Dados do valor:
- 0 - rastreamento de arquivo desabilitado
- 1 - rastreamento de arquivo habilitado

Para criar a chave de registro “LogToFile” em um VDA usando o PowerShell, use o seguinte cmdlet:

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

Para habilitar o “LogToFile” para grupos de máquinas em escala, considere criar o registro “LogToFile” em todas as unidades organizacionais (OUs) de VDA por meio da Preferência de Política de Grupo.

Observação:

Quando LogToFile=1 é definido, os logs são gravados apenas no arquivo. Eles não aparecerão nos rastreamentos CDF.

É necessário reiniciar o serviço do Agente de Atualização de VDA para que a alteração no registro entre em vigor.

O arquivo de log é criado na pasta C:\ProgramData\Citrix\Update Services\Logs.

Solucionar problemas de falhas de download da atualização de VDA

Siga as etapas abaixo para solucionar e resolver falhas de download relacionadas ao recurso de atualização de VDA:

Certifique-se de que as URLs relevantes foram adicionadas à lista de permissões, caso o filtro de URL esteja em vigor. Consulte Conectividade.
Após adicionar as URLs necessárias à lista de permissões, tente reagendar a atualização do VDA.

Você pode habilitar o rastreamento CDF ou definir LogToFile como 1 para capturar logs detalhados para análise. Se o problema de falha de download persistir, verifique os erros. Se você vir a seguinte mensagem de erro “Download Failed: This access control list is not in canonical form and therefore cannot be modified”, isso indica que as permissões na pasta C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA estão incorretas.

Para resolver o problema, faça o seguinte:

Opção 1: Redefina as listas de controle de acesso (ACLs) na pasta usando o seguinte comando. (O comando redefine as ACLs com ACLs herdadas padrão para todos os arquivos correspondentes.)
- icacls.exe “C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA” /reset /T /C /L /Q
Opção 2: Exclua a pasta VDA em “Downloads” e, em seguida, agende a atualização do VDA.

Solucionar problemas de falhas de validação da atualização de VDA

Siga as etapas abaixo para solucionar e resolver falhas de download relacionadas ao recurso de atualização de VDA:

Certifique-se de que as URLs relevantes foram adicionadas à lista de permissões, caso o filtro de URL esteja em vigor, especialmente as URLs da Lista de Revogação de Certificados (CRL) ou do Protocolo de Status de Certificado Online (OCSP) necessárias para a verificação de revogação. Consulte Requisito de atualização de VDA.
Após adicionar as URLs necessárias à lista de permissões, tente reagendar a atualização do VDA.

Sugerimos habilitar o rastreamento CDF ou definir LogToFile como 1 para capturar logs detalhados para análise. Os logs podem incluir os seguintes erros:

RevocationStatusUnknown
A função de revogação não conseguiu verificar o status de revogação do certificado.
A função de revogação não conseguiu verificar a revogação porque o servidor de revogação estava offline.

O Agente de Atualização de VDA depende de chamadas de sistema do Windows para validar certificados e realizar verificações de revogação. Os erros acima indicam que o agente não consegue estabelecer uma conexão com as URLs CRL ou OCSP.

A CryptoAPI do Windows atualmente não oferece suporte a configurações de proxy. Revise a seção VDAs com configurações de proxy para configurar seus proxies de VDA para facilitar chamadas CRL de saída.

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Monitoramento e Solução de Problemas

January 23, 2026

Contribuição de:

January 23, 2026

Contribuição de:

Neste artigo

Monitoramento de Atualizações Agendadas de VDA
Solução de Problemas de Atualizações Agendadas de VDA

Isso foi útil?