Resolução de problemas

Comece aqui quando algo não estiver funcionando. Siga estes passos para identificar o seu problema e ir para a página de resolução relevante.

Antes de começar

Se vários usuários relatarem o mesmo problema ao mesmo tempo, ou se os logs de depuração do KONNEKT mostrarem erros da Graph API (HTTP 429, 500, 503, 504, ou UnknownError), a causa raiz pode estar no backend do Microsoft 365 em vez de no KONNEKT. Confirme isso primeiro: Reproduza problemas de arquivos com o Graph Explorer.

Qual é o problema?

As unidades ou compartilhamentos do KONNEKT não estão visíveis

1. O KONNEKT está instalado?

   • Verifique: Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -like "*Konnekt*" }
   • Não instalado → Instale o KONNEKT
   • Em dispositivos ARM64, certifique-se de que instalou a versão ARM64. Uma instalação x64 em ARM64 parecerá bem-sucedida, mas o driver não conseguirá carregar. → Falha ao abrir o dispositivo
2. O dispositivo foi reiniciado após a instalação?

   • O KONNEKT requer uma reinicialização para carregar seu driver em modo kernel. Reinicie e verifique novamente.
3. O serviço do KONNEKT está em execução?

   • Verifique: Get-Service -Name "Konnekt*"
   • Não está em execução → reinicie o serviço ou reinstale.
4. O usuário está conectado?

   • Clique com o botão direito no ícone da bandeja do KONNEKT → Contas. Se nenhuma conta estiver listada, faça login.
   • "É necessária aprovação do administrador" → Conceda consentimento de administrador para todo o Tenant
5. A unidade ou compartilhamento está visível, mas clicar não faz nada?

   • → Clicar em um compartilhamento não faz nada

Sites ou bibliotecas estão ausentes

1. Usando mapeamento automático?

   • Verifique se O365SharepointUsage = 1 no registro.
   • Verifique se o usuário tem acesso ao site na interface web do SharePoint.
   • Verifique a consulta KQL do site - uma consulta restritiva pode excluir o site. Veja Mapeamento automático.
   • Verifique a associação do usuário ao grupo do Microsoft Entra ID se os sites forem filtrados por grupo.
   • Proprietário do site, mas não membro? A descoberta do KONNEKT encontra apenas sites dos quais o usuário é membro de. → Alguns sites ou bibliotecas não aparecem no KONNEKT
2. Usando mapeamentos gerenciados?

   • Verifique se a SharepointSites política está aplicada: gpresult /r ou verifique o registro.
   • Verifique se a URL do SharePoint na política está correta e acessível.
3. Tentando adicionar um compartilhamento manualmente e recebendo "Falha ao abrir o site: chave não encontrada"?

   • → Adicionar compartilhamento: "Chave não encontrada"
4. O site existe no SharePoint, mas não no KONNEKT?

   • O usuário pode não ter permissão para o site. Teste o acesso pela interface web do SharePoint.
   • O tipo de site pode não corresponder à consulta KQL (por exemplo, sites pessoais do OneDrive não são descobertos pela consulta padrão).

→ Sites ausentes ou pastas vazias | Alguns sites ou bibliotecas não aparecem

As pastas estão vazias

1. Todas as bibliotecas estão vazias?

   • Talvez o consentimento do administrador não tenha sido concedido, ou as permissões da API estejam incompletas.
   • → Conceda consentimento de administrador para todo o Tenant
   • → Bibliotecas vazias
2. Alguma biblioteca específica está vazia?

   • O usuário pode não ter permissão para o conteúdo da biblioteca. Verifique as permissões do SharePoint.
   • A biblioteca pode realmente estar vazia.
3. O mapeamento gerenciado mostra uma pasta vazia?

   • A URL do site na política pode estar incorreta. Verifique-a abrindo a URL em um navegador.

→ Bibliotecas vazias | Sites ausentes ou pastas vazias

Erros de autenticação

1. "Falha ao obter token de acesso"

   • → Problemas com token de acesso
2. Loop de solicitação de MFA (solicitações de MFA repetidas)

   • Conflito de política do Conditional Access ou problema no broker WAM.
   • → Conditional Access
3. Conta errada conectada

   • Clique com o botão direito no ícone da bandeja → Contas → remova a conta errada → adicione a conta correta.
4. "É necessária aprovação do administrador"

   • → Conceda consentimento de administrador para todo o Tenant

→ Problemas com token de acesso

Erros de operação de arquivo

1. Falha no envio

   • Verifique os detalhes do erro pelo ícone da bandeja → Erros.
   • Verifique a conectividade de rede.
   • Verifique se está ocorrendo limitação de taxa no SharePoint (procure HTTP 429 nos logs de depuração). Se você vir limitação de taxa ou erros do backend, reproduza com o Graph Explorer para confirmar problemas do lado da Microsoft.
   • → Como lidar com erro(s)
2. Arquivo bloqueado / somente leitura inesperadamente

   • Outro usuário pode ter o arquivo aberto sem a coautoria ativada.
   • O arquivo pode exceder o limite de tamanho para somente leitura. → Limites de tamanho para abertura de arquivos
3. Permissão negada

   • O usuário não tem permissão de gravação no SharePoint. Verifique pela interface web.
4. "Caminho muito longo" ou erros de nome de arquivo

   • Verifique o comprimento do caminho e do nome do arquivo em relação aos limites. → Qual é o comprimento máximo do caminho e do nome do arquivo?

→ Como lidar com erro(s)

A abertura de arquivos do Office falha

1. Office exibe um aviso ao abrir ("pode prejudicar seu computador")

   • A Marcação da Web (MOTW) é aplicada a arquivos de locais de rede. → A abertura de documentos do MS Office exibe uma mensagem de aviso
   • Frequentemente resolvido adicionando os caminhos do KONNEKT aos sites confiáveis. → Adicione os caminhos do KONNEKT como sites confiáveis
2. Dar duplo clique em um arquivo do Office não faz nada ou arquivos de macro do Excel não abrem

   • Os caminhos do KONNEKT precisam estar na zona de Sites confiáveis. → Adicione os caminhos do KONNEKT como sites confiáveis
3. O KONNEKT trava ao abrir ou pré-visualizar arquivos do Office

   • As regras de Attack Surface Reduction (ASR) podem estar bloqueando o KONNEKT. Exclua Konnekt.exe e KonnektStarter.exe da regra ASR "Office Child Process". → Ação arriscada bloqueada
4. Office mostra uma versão desatualizada de um arquivo

   • → Office mostra versões desatualizadas

Problemas de desempenho

1. Navegação lenta pelas pastas

   • Verifique a contagem de itens na pasta (>1.000 itens tornam a navegação lenta).
   • Verifique as configurações de cache - um TTL muito baixo causa mais chamadas à API.
   • Se a lentidão estiver correlacionada com erros 429 ou 5xx da Graph API no log de depuração, reproduza com o Graph Explorer para confirmar limitação de taxa ou problemas do backend.
2. Abertura lenta de arquivos

   • Verifique o tamanho do arquivo e a largura de banda da rede.
   • Verifique se há limitação de taxa (HTTP 429 nos logs). Se houver, reproduza com o Graph Explorer.
3. Lentidão intermitente (especialmente de manhã)

   • Provavelmente o antivírus está verificando as unidades do KONNEKT.
   • → Desempenho lento ou erros causados pela verificação do antivírus

Outros problemas

Problema	Resolução
Pré-visualização de PDF com falha (Windows 11)	→ Pré-visualização de PDF com falha após a atualização do Windows 11
X cinza nos arquivos	Comportamento esperado - o KONNEKT marca os arquivos como FILE_ATTRIBUTE_OFFLINE para economizar largura de banda. Não é um erro. Veja Por que há um X cinza ou uma mala marrom.
Sobreposição de mala marrom nos arquivos	O arquivo está marcado para uso offline. Comportamento esperado.
Ícone da bandeja do KONNEKT ausente	Reinicie o dispositivo. Se ainda estiver ausente, reinstale o KONNEKT.
Não consegue resolver o problema	→ Prepare os logs de depuração e contate o suporte

Páginas relacionadas

• Reproduza problemas de arquivos com o Graph Explorer - isolar problemas do KONNEKT de problemas do backend do Microsoft 365
• Registro de alterações - correções recentes e problemas resolvidos
• Preparação dos logs de depuração - como coletar logs para o suporte
• Suporte - como contatar o suporte do KONNEKT