Motivos de falha e solução de problemas do Citrix Director

Last published : Nov 13, 2026
As tabelas a seguir descrevem as várias categorias de falha, os motivos e a ação que você precisa tomar para resolver os problemas. Para obter mais informações, consulte Enums, códigos de erro e descrições.
Related information
Director

Erros de falha de conexão

Categoria Motivo Problema Ação
N/A [0] Desconhecido. Este código de erro não está mapeado. O serviço de Monitoramento não consegue determinar o motivo da falha de inicialização ou conexão relatada a partir das informações compartilhadas pelo serviço de Brokering. Colete logs CDF no controlador e entre em contato com o suporte da Citrix.
[0] Nenhum [1] Nenhum Nenhum N/A
[2] MachineFailure [2] SessionPreparation A solicitação de preparação de sessão do controlador de entrega para o VDA falhou. Causas possíveis: Problemas de comunicação entre o controlador e o VDA, problemas encontrados pelo Serviço de Broker ao criar uma solicitação de preparação ou problemas de rede que resultam na não aceitação da solicitação pelo VDA. Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Solução de problemas de registro do Virtual Delivery Agent com controladores de entrega no Citrix Virtual Apps and Desktops para problemas comuns que causam problemas de comunicação entre o controlador e o VDA.
[2] MachineFailure [3] RegistrationTimeout O VDA foi ligado, mas ocorreu um tempo limite enquanto ele tentava se registrar com o controlador de entrega. Verifique se o Citrix Broker Service está em execução no delivery controller e se o serviço Desktop está em execução no VDA. Inicie cada um se estiverem parados.
[1] ClientConnectionFailure [4] ConnectionTimeout O cliente não se conectou ao VDA depois que o VDA foi preparado para o lançamento da sessão. A sessão foi intermediada com sucesso, mas ocorreu um tempo limite enquanto se aguardava a conexão do cliente com o VDA. Causas possíveis: Configurações de firewall, interrupções de rede ou configurações que impedem conexões remotas. Verifique o console do Director para ver se o cliente tem uma conexão ativa no momento, o que significa que nenhum usuário é afetado. Se nenhuma sessão existir, revise os logs de eventos no cliente e no VDA em busca de erros. Resolva quaisquer problemas de conectividade de rede entre o cliente e o VDA.
[4] NoLicensesAvailable [5] Licensing A solicitação de licenciamento falhou. Causas possíveis: Número insuficiente de licenças, ou o servidor de licenças está inativo há mais de 30 dias. Verifique se o servidor de licenças está online e acessível. Resolva quaisquer problemas de conectividade de rede com o servidor de licenças ou reinicie o servidor de licenças se ele parecer estar com defeito. Verifique se há licenças suficientes no ambiente e aloque mais, se necessário.
[1] ClientConnectionFailure [6] Ticketing Ocorreu uma falha durante a emissão do ticket, indicando que a conexão do cliente com o VDA não corresponde à solicitação intermediada. Um ticket de solicitação de lançamento é preparado pelo Broker e entregue no arquivo ICA®. Quando o usuário tenta iniciar uma sessão, o VDA valida o ticket de lançamento no arquivo ICA com o Broker. Causas possíveis: O arquivo ICA está corrompido ou o usuário está tentando fazer uma conexão não autorizada. Verifique se o usuário tem acesso ao aplicativo ou desktop com base nos grupos de usuários definidos nos grupos de entrega. Instrua o usuário a reiniciar o aplicativo ou desktop para determinar se este é um problema pontual. Se o problema ocorrer novamente, revise os logs de eventos do dispositivo cliente em busca de erros. Verifique se o VDA ao qual o usuário está tentando se conectar está registrado. Se não estiver registrado, revise os logs de eventos no VDA e resolva quaisquer problemas de registro.
[1] ClientConnectionFailure [7] Other Uma sessão foi relatada como encerrada a partir do VDA depois que o cliente contatou inicialmente o VDA, mas antes de concluir a sequência de conexão. Verifique se a sessão não foi encerrada pelo usuário antes do lançamento. Tente relançar a sessão; se o problema persistir, colete os logs CDF e entre em contato com o suporte da Citrix.
[1] Falha na Conexão do Cliente [8] Falha Geral A sessão falhou ao iniciar. Causas possíveis: Um lançamento intermediado foi solicitado enquanto o intermediador ainda estava iniciando ou inicializando, ou um erro interno durante a fase de intermediação de um lançamento. Verifique se o Serviço de Broker da Citrix está em execução e tente novamente iniciar a sessão.
[5] Configuração [9] ModoDeManutenção O VDA, ou o grupo de entrega ao qual o VDA pertence, está configurado no modo de manutenção. Determine se o modo de manutenção é necessário. Desative o modo de manutenção no grupo de entrega ou na máquina em questão, se não for necessário, e instrua o usuário a tentar reconectar.
[5] Configuração [10] AplicativoDesabilitado O aplicativo não pode ser acessado pelos usuários finais porque foi desabilitado pelo administrador. Se o aplicativo for destinado a estar disponível para uso em produção, habilite o aplicativo e instrua o usuário a reconectar.
[4] SemLicençasDisponíveis [11] Recurso de Licença Recusado O recurso que está sendo usado não é coberto pelas licenças existentes. Entre em contato com um representante de vendas da Citrix para confirmar os recursos cobertos pela edição e tipo de licença existentes do Citrix Virtual Apps and Desktops™.
[3] Nenhuma Capacidade Disponível [13] Limite de Sessões Atingido Todos os VDAs estão em uso e não há capacidade para hospedar mais sessões. Causas possíveis: Todos os VDAs estão em uso (para VDAs de SO de sessão única), ou todos os VDAs atingiram o número máximo configurado de sessões simultâneas permitidas (para VDAs de SO de múltiplas sessões). Verifique se há VDAs em modo de manutenção. Desative o modo de manutenção se não for necessário para liberar mais capacidade. Considere aumentar o valor de Número Máximo de Sessões na configuração da política Citrix para permitir mais sessões por VDA de servidor. Considere adicionar mais VDAs de SO de múltiplas sessões. Considere adicionar mais VDAs de SO de sessão única.
[5] Configuração [14] Protocolo Não Permitido Os protocolos ICA e RDP não são permitidos. Execute o comando PowerShell Get-BrokerAccessPolicyRule no delivery controller e verifique se o valor de AllowedProtocols lista todos os protocolos desejados. Este problema ocorre apenas se houver uma configuração incorreta.
[5] Configuração [15] Recurso Indisponível O aplicativo ou desktop ao qual o usuário está tentando se conectar não está disponível. Este aplicativo ou desktop pode não existir, ou não há VDAs disponíveis para executá-lo. Causas possíveis: O aplicativo ou desktop foi despublicado, ou os VDAs que hospedam o aplicativo ou desktop atingiram a carga máxima, ou o aplicativo ou desktop está definido em modo de manutenção. Verifique se o aplicativo ou desktop ainda está publicado e se os VDAs não estão em modo de manutenção. Determine se os VDAs de SO de múltiplas sessões estão com carga total. Se sim, provisione mais VDAs de SO de múltiplas sessões. Verifique se há VDAs de SO de sessão única disponíveis para conexões. Provisione mais VDAs de SO de sessão única, se necessário.
[5] Configuração [16] ActiveSessionReconnectDisabled A sessão ICA está ativa e conectada a um endpoint diferente. No entanto, como a Reconexão de Sessão Ativa está desabilitada, o cliente não consegue se conectar à sessão ativa. No controlador de entrega, verifique se a Reconexão de Sessão Ativa está habilitada. Verifique se o valor de DisableActiveSessionReconnect no registro, em HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server, está definido como 0.
[2] MachineFailure [17] NoSessionToReconnect O cliente tentou se reconectar a uma sessão específica, mas a sessão foi encerrada. Tente novamente a reconexão do controle de workspace.
[2] MachineFailure [18] SpinUpFailed O VDA não pode ser ligado para o lançamento da sessão. Este é um problema relatado pelo hypervisor. Se a máquina ainda estiver desligada, tente iniciá-la a partir do Citrix Studio. Se isso falhar, revise a conectividade e as permissões do hypervisor. Se o VDA for uma máquina provisionada por PVS, verifique no console do PVS se a máquina está em execução. Caso contrário, verifique se a máquina tem um vDisk Pessoal atribuído, faça login no hypervisor para redefinir a VM.
[2] MachineFailure [19] Refused O controlador de entrega envia uma solicitação ao VDA para se preparar para uma conexão de um usuário final, mas o VDA recusa ativamente esta solicitação. Verifique via ping se o delivery controller e o VDA podem se comunicar com sucesso. Caso contrário, resolva quaisquer problemas de firewall ou roteamento de rede.
[2] Falha da Máquina [20] Falha do Conjunto de Configurações O delivery controller não enviou os dados de configuração necessários, como configurações de política e informações de sessão, para o VDA durante o lançamento da sessão. Causas possíveis: Problemas de comunicação entre o controller e o VDA, problemas encontrados pelo Serviço de Broker ao criar uma solicitação de conjunto de configurações, ou problemas de rede que resultam na não aceitação da solicitação pelo VDA. -
[3] NenhumaCapacidadeDisponível [21] MaxTotalDeInstânciasExcedido O número máximo de instâncias de um aplicativo foi atingido. Nenhuma instância adicional do aplicativo pode ser aberta no VDA. Este problema está relacionado ao recurso de limites de aplicativo. Considere aumentar a configuração do aplicativo, Limitar o número de instâncias em execução ao mesmo tempo, para um valor mais alto, se o licenciamento permitir.
[3] NenhumaCapacidadeDisponível [22] MaxInstânciasPorUsuárioExcedido O usuário está tentando abrir mais de uma instância de um aplicativo, mas o aplicativo está configurado para permitir apenas uma única instância do aplicativo por usuário. Este problema está relacionado ao recurso de limites de aplicativo. Apenas uma instância do aplicativo é permitida por usuário por padrão. Se forem necessárias várias instâncias por usuário, considere desmarcar a configuração Limitar a uma instância por usuário na configuração do aplicativo.
[1] FalhaDeConexãoDoCliente [23] Erro de comunicação O delivery controller tentou enviar informações ao VDA, como uma solicitação para preparar uma conexão, mas ocorreu um erro durante a tentativa de comunicação. Isso pode ser causado por interrupções na rede. Se já iniciado, reinicie o serviço Desktop no VDA para reiniciar o processo de registro e verifique se o VDA se registra com sucesso. Confirme se os controladores de entrega configurados para o VDA estão corretos por meio dos detalhes no log de eventos do aplicativo.
[3] NoCapacityAvailable [100] NoMachineAvailable O serviço de monitoramento converte [12] NoDesktopAvailable para este código de erro. O VDA atribuído para iniciar a sessão está em um estado inválido ou indisponível. Causas possíveis: O estado de energia do VDA é desconhecido ou indisponível, o VDA não foi reiniciado desde a última sessão do usuário, o compartilhamento de sessão está desabilitado enquanto a sessão atual exige que ele esteja habilitado, ou o VDA foi removido do grupo de entrega ou do site. Verifique se o VDA está em um grupo de entrega. Caso contrário, adicione-o ao grupo de entrega apropriado. Verifique se há VDAs suficientes registrados e em estado pronto para poder iniciar o desktop compartilhado publicado ou o aplicativo solicitado pelo usuário. Verifique se o hipervisor que hospeda o VDA não está em modo de manutenção.
[2] MachineFailure [101] MachineNotFunctional. O serviço de monitoramento converte [12] NoDesktopAvailable para este código de erro. O VDA não está operacional. Causas possíveis: O VDA foi removido do grupo de entrega, o VDA está não registrado, o estado de energia do VDA está indisponível ou o VDA está enfrentando problemas internos. Verifique se o VDA está em um grupo de entrega. Caso contrário, adicione-o ao grupo de entrega apropriado. Verifique se o VDA aparece como ligado no Citrix Studio. Se o estado de energia for desconhecido para várias máquinas, resolva quaisquer problemas de conectividade com o hipervisor ou falhas de host. Verifique se o hipervisor que hospeda o VDA não está em modo de manutenção. Reinicie o VDA assim que esses problemas forem resolvidos.

Tipo de falha da máquina

Código de Erro ID do Código de Erro Problema Ação
Desconhecido - - -
Não registrado 3 - -
Capacidade Máxima (representada como Carga Máxima no Director) 4 A máquina está se reportando com capacidade máxima, ou seja, Índice de Carga Máxima Certifique-se de que todos os hipervisores estejam ligados. Adicione mais máquinas aos Delivery Groups afetados, adicionando mais capacidade ao hipervisor ou adicionando mais hipervisores.
StuckOnBoot 2 A VM não concluiu sua sequência de inicialização e não está se comunicando com o hipervisor. Certifique-se de que a VM inicializou com sucesso no hipervisor. Verifique outras mensagens na VM, como problemas de SO. Certifique-se de que as ferramentas do hipervisor estejam instaladas na VM. Certifique-se de que o VDA esteja instalado na VM.
FailedToStart 1 A VM encontrou problemas ao tentar iniciar no hipervisor. Verifique os logs do hipervisor.
Nenhum 0 - -

Motivo do cancelamento de registro da máquina (aplicável quando o tipo de falha é Não Registrado ou Desconhecido)

Código de Erro ID do Código de Erro Problema Ação
AgentShutdown 0 O VDA passou por um desligamento normal. Ligue o VDA se você não espera que ele esteja desligado com base nas políticas de gerenciamento de energia existentes. Revise quaisquer erros nos logs de eventos.
AgentSuspended 1 O VDA está em modo de hibernação ou suspensão. Tire o VDA do modo de hibernação. Considere desabilitar a hibernação para VDAs do Citrix Virtual Apps™ and Desktops através das configurações de energia.
IncompatibleVersion 100 O VDA não consegue se comunicar com o delivery controller devido a uma incompatibilidade nas versões do protocolo Citrix. Alinhe as versões do VDA e do delivery controller.
AgentAddressResolutionFailed 101 O delivery controller não conseguiu resolver o endereço IP do VDA. Verifique se a conta da máquina VDA existe no AD. Caso contrário, crie-a. Verifique se o nome e o endereço IP do VDA no DNS estão corretos. Caso contrário, corrija-os. Se for generalizado, valide as configurações de DNS nos delivery controllers. Verifique a resolução de DNS a partir do controller executando o comando nslookup.
[Cloud]:AgentAddressResolutionFailed 101 O delivery controller não conseguiu resolver o endereço IP do VDA. Verifique se a conta da máquina VDA existe no AD. Caso contrário, crie-a. Verifique se o nome e o endereço IP do VDA no DNS estão corretos. Caso contrário, corrija-os.
AgentNotContactable 102 Ocorreu um problema de comunicação entre o delivery controller e o VDA. Use um ping para verificar se o controlador de entrega e o VDA podem se comunicar com sucesso. Caso contrário, resolva quaisquer problemas de firewall ou rede. Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Solução de problemas de registro do Virtual Delivery Agent com controladores de entrega no Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controlador e o VDA.
[Cloud]: AgentNotContactable 102 Ocorreu um problema de comunicação entre o controlador de entrega e o VDA. Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Solução de problemas de registro do Virtual Delivery Agent com controladores de entrega no Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controlador e o VDA. Entre em contato com o suporte da Citrix.
AgentWrongActiveDirectoryOU 103 Ocorreu uma configuração incorreta de descoberta do Active Directory. A OU específica do site (onde as informações do controlador do site são armazenadas no AD) configurada no registro do VDA é para um Site diferente. Certifique-se de que a configuração do Active Directory esteja correta ou verifique as configurações do registro.
EmptyRegistrationRequest 104 A solicitação de registro enviada do VDA para o controlador de entrega estava vazia. Isso pode ser devido a uma instalação de software VDA corrompida. Reinicie o serviço Desktop no VDA para reiniciar o processo de registro e verifique se o VDA se registra corretamente através do log de eventos do aplicativo.
MissingRegistrationCapabilities 105 A versão do VDA não é compatível com o delivery controller. Atualize o VDA ou remova o VDA e reinstale-o.
MissingAgentVersion 106 A versão do VDA não é compatível com o delivery controller. Reinstale o software VDA se o problema estiver afetando todas as máquinas.
InconsistentRegistrationCapabilities 107 O VDA não consegue comunicar suas capacidades ao Broker. Isso pode ser devido à incompatibilidade entre as versões do VDA e do delivery controller. As capacidades de registro, que mudam a cada versão, são expressas em um formato que não corresponde à solicitação de registro. Alinhe as versões do VDA e do delivery controller.
NotLicensedForFeature 108 O recurso que você está tentando usar não está licenciado. Verifique sua edição de licenciamento Citrix, ou remova o VDA e reinstale-o.
[Cloud]: NotLicensedForFeature 108 O recurso que você está tentando usar não está licenciado. Entre em contato com o suporte da Citrix.
Versão UnsupportedCredentialSecurity 109 O VDA e o delivery controller não estão usando o mesmo mecanismo de criptografia. Alinhe as versões do VDA e do delivery controller.
InvalidRegistrationRequest 110 O VDA fez uma solicitação de registro ao Broker, mas o conteúdo da solicitação está corrompido ou é inválido. Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Solução de problemas de registro do Virtual Delivery Agent com controladores de entrega no Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controlador e o VDA.
SingleMultiSessionMismatch 111 O tipo de sistema operacional do VDA não é compatível com o catálogo de máquinas ou grupo de entrega. Adicione o VDA ao tipo de catálogo de máquinas ou grupo de entrega correto que contenha máquinas com o mesmo sistema operacional.
FunctionalLevelTooLowForCatalog 112 O catálogo de máquinas está configurado para um nível funcional de VDA superior do que a versão do VDA instalada. Verifique se o nível funcional do catálogo de máquinas do VDA corresponde ao do VDA. Atualize ou faça o downgrade do catálogo de máquinas para corresponder ao do VDA.
FunctionalLevelTooLowForDesktopGroup 113 O grupo de entrega está configurado para um nível funcional de VDA superior do que a versão do VDA instalada. Verifique se o nível funcional do grupo de entrega do VDA corresponde ao do VDA. Atualize ou faça o downgrade do catálogo de máquinas para corresponder ao do VDA.
PowerOff 200 O VDA não foi desligado corretamente. Se o VDA deveria estar ligado, tente iniciar o VDA a partir do Citrix Studio e verifique se ele inicializa e se registra corretamente. Solucione quaisquer problemas de inicialização ou registro. Revise os logs de eventos no VDA assim que ele estiver novamente em funcionamento para ajudar a determinar a causa raiz do desligamento.
AgentRejectedSettingsUpdate 203 Configurações como políticas do Citrix foram alteradas ou atualizadas, mas houve um erro ao enviar as atualizações para o VDA. Isso pode ocorrer se as atualizações forem incompatíveis com a versão do VDA instalada. Atualize o VDA, se necessário. Verifique se as atualizações aplicadas são compatíveis com a versão do VDA.
SessionPrepareFailure 206 O Broker não concluiu uma auditoria das sessões em execução no VDA. Se generalizado, reinicie o Citrix Broker Service no delivery controller.
[Cloud]: SessionPrepareFailure 206 O Broker não concluiu uma auditoria das sessões em execução no VDA. Entre em contato com o suporte da Citrix.
ContactLost 207 O delivery controller perdeu a conexão com o VDA. Isso pode ser causado por interrupções na rede. Verifique se o Citrix Broker Service está em execução no delivery controller e se o serviço Desktop está em execução no VDA. Inicie cada um, se estiverem parados. Se já estiverem iniciados, reinicie o serviço Desktop no VDA para reiniciar o processo de registro e verifique se o VDA se registra com sucesso. Confirme se os delivery controllers configurados para o VDA estão corretos por meio dos detalhes no log de eventos do Aplicativo. Use um ping para verificar se o delivery controller e o VDA podem se comunicar com sucesso. Caso contrário, resolva quaisquer problemas de firewall ou rede.
[Cloud]: ContactLost 207 O delivery controller perdeu a conexão com o VDA. Isso pode ser causado por interrupções de rede. Verifique se o serviço Desktop está em execução no VDA. Inicie-o se estiver parado.
BrokerRegistrationLimitReached 301 O delivery controller atingiu o número máximo configurado de VDAs que podem se registrar simultaneamente. Por padrão, o delivery controller permite 10.000 registros simultâneos de VDA. Considere adicionar delivery controllers ao Site ou criar um Site. Você também pode aumentar o número de VDAs permitidos para se registrar simultaneamente com o delivery controller através da chave de registro HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers. Consulte o artigo da Central de Conhecimento, Entradas de Chave de Registro Usadas pelo Citrix Virtual Apps and Desktops (CTX117446) para obter mais informações. Aumentar esse número pode exigir mais recursos de CPU e memória para o controller.
SettingsCreationFailure 208 O Broker não construiu um conjunto de configurações para enviar ao VDA. Se o Broker não conseguir coletar os dados, o registro falhará e o VDA ficará não registrado. Verifique os logs de eventos no delivery controller para quaisquer erros. Reinicie o Serviço Broker se um problema específico não for evidente nos logs. Uma vez que o Serviço Broker seja reiniciado, reinicie o serviço Desktop nos VDAs afetados e verifique se eles se registram com sucesso.
[Cloud]: SettingsCreationFailure 208 O Broker não construiu um conjunto de configurações para enviar ao VDA. Se o Broker não conseguir coletar os dados, o registro falhará e o VDA ficará não registrado. Reinicie o serviço Desktop nos VDAs afetados e verifique se eles se registram com sucesso. Entre em contato com o suporte da Citrix.
SendSettingsFailure 204 O Broker não enviou dados de configurações e configuração para o VDA. Se o Broker puder coletar os dados, mas não conseguir enviá-los, o registro falhará. Se limitado a um único VDA, reinicie o serviço Desktop no VDA para forçar o novo registro e valide se o VDA se registra com sucesso através do log de eventos do aplicativo. Solucione quaisquer erros encontrados. Consulte as etapas de solução de problemas listadas no artigo da Central de Conhecimento, Solução de problemas de registro do Virtual Delivery Agent com controladores de entrega no Citrix Virtual Apps and Desktops (CTX136668), para problemas comuns que causam problemas de comunicação entre o controlador e o VDA.
AgentRequested 2 Ocorreu um erro desconhecido. Entre em contato com o suporte da Citrix.
DesktopRestart 201 Ocorreu um erro desconhecido. Entre em contato com o suporte da Citrix.
DesktopRemoved 202 Ocorreu um erro desconhecido. Entre em contato com o suporte da Citrix.
SessionAuditFailure 205 Ocorreu um erro desconhecido. Entre em contato com o suporte da Citrix.
UnknownError 300 Ocorreu um erro desconhecido. Entre em contato com o suporte da Citrix.
RegistrationStateMismatch 302 Ocorreu um erro desconhecido. Entre em contato com o suporte da Citrix.
Desconhecido - Ocorreu um erro desconhecido. Entre em contato com o suporte da Citrix.