Compartilhar via


Solucionar problemas na instalação do agente e no registro do servidor da Sincronização de Arquivos do Azure

Depois de implantar o Serviço de Sincronização de Armazenamento, as próximas etapas na implantação da Sincronização de Arquivos do Azure são instalar o agente da Sincronização de Arquivos do Azure e registrar o Windows Server com o Serviço Sincronização de Armazenamento. Este artigo foi criado para ajudar você a solucionar problemas encontrados durante essas etapas.

Instalação do agente

Como verificar se uma instalação do agente de Sincronização de Arquivos do Azure requer uma reinicialização

A instalação de um agente de Sincronização de Arquivos do Azure pode precisar de uma reinicialização para ser concluída. Por exemplo, a versão 19.1.0.0 do agente de Sincronização de Arquivos do Azure exigirá uma reinicialização nos servidores se estiver atualizando de uma versão anterior à 18.2.0.0.

Se o agente for atualizado usando o recurso de atualização automática, execute os seguintes comandos do PowerShell para verificar se uma reinicialização é necessária para concluir a atualização automática do agente:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Get-StorageSyncServer

Se o valor da RebootNeeded propriedade for True, será necessário reiniciar.

A atualização do agente não é concluída

Ao atualizar o agente de Sincronização de Arquivos do Azure, você pode enfrentar um dos seguintes sintomas:

  • AfsUpdater.exe trava em "instalando atualizações".
  • A instalação do agente trava em "Parando o agente de monitoramento".

Esse problema ocorrerá se a versão do agente de Sincronização de Arquivos do Azure instalada no momento for anterior à v16.2 e o processo de Logman.exe não for desligado.

Para resolver esse problema, execute as seguintes etapas:

  1. Abra o Gerenciador de Tarefas.
  2. Clique com o botão direito do mouse no processo LogMan e selecione Finalizar tarefa. Repita essa etapa até que todos os processos do LogMan sejam interrompidos e a atualização do agente seja concluída com êxito.

Como solucionar problemas de falhas de instalação do agente

Se a instalação do agente de Sincronização de Arquivos do Azure falhar, localize o arquivo de log de instalação localizado no diretório de instalação do agente. Se o agente de Sincronização de Arquivos do Azure estiver instalado no volume C: , o arquivo de log de instalação estará localizado em C:\Program Files\Azure\StorageSyncAgent\InstallerLog.

Observação

Se o agente de Sincronização de Arquivos do Azure for instalado na linha de comando e a /l\*v opção for usada, o arquivo de log estará localizado no caminho em que a instalação do agente foi executada.

O nome do arquivo de log para instalações de agente usando o pacote MSI é AfsAgentInstall. O nome do arquivo de log para instalações de agente usando o pacote MSP (pacote de atualização) é AfsUpdater.

Após ter localizado o arquivo de log de instalação do agente, abra o arquivo e procure o código de falha no final do log. Se você pesquisar por "código de erro 1603" ou "sandbox", poderá localizar o código de erro.

Aqui está um snippet de uma instalação do agente que falhou:

CAQuietExec64:      + CategoryInfo          : SecurityError: (:) , PSSecurityException  
CAQuietExec64:      + FullyQualifiedErrorId : UnauthorizedAccess  
CAQuietExec64:  Error 0x80070001: Command line returned an error.  
CAQuietExec64:  Error 0x80070001: QuietExec64 Failed  
CAQuietExec64:  Error 0x80070001: Failed in ExecCommon64 method  
CustomAction SetRegPIIAclSettings returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)  
Action ended 12:23:40: InstallExecute. Return value 3.  
MSI (s) (0C:C8) [12:23:40:994]: Note: 1: 2265 2:  3: -2147287035

Para esse exemplo, a instalação do agente falhou com o código de erro -2147287035 (ERROR_ACCESS_DENIED).

Falha na instalação do agente com erro: o Assistente de Instalação do agente de sincronização de armazenamento foi encerrado prematuramente devido a um erro

No log de instalação do agente, o seguinte erro é registrado:

CAQuietExec64:      + CategoryInfo          : SecurityError: (:) , PSSecurityException  
CAQuietExec64:      + FullyQualifiedErrorId : UnauthorizedAccess  
CAQuietExec64:  Error 0x80070001: Command line returned an error.  
CAQuietExec64:  Error 0x80070001: QuietExec64 Failed  
CAQuietExec64:  Error 0x80070001: Failed in ExecCommon64 method  
CustomAction SetRegPIIAclSettings returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)  
Action ended 12:23:40: InstallExecute. Return value 3.  
MSI (s) (0C:C8) [12:23:40:994]: Note: 1: 2265 2:  3: -2147287035 

Esse problema ocorre se a política de execução do PowerShell estiver configurada usando a política de grupo e a configuração de política for "Permitir apenas scripts assinados". Todos os scripts incluídos no agente da Sincronização de Arquivos do Azure são assinados. A instalação do agente de Sincronização de Arquivos do Azure falha porque o instalador está realizando a execução do script usando a configuração de política Bypass execução.

Para resolver esse problema, desabilite temporariamente a configuração da política Ativar execução de script no servidor. Assim que a instalação do agente for concluída, a configuração da política de grupo pode ser reativada.

A instalação do agente falha no Controlador de Domínio do Active Directory

No log de instalação do agente, o seguinte erro é registrado:

CAQuietExec64:  Error 0x80070001: Command line returned an error.
CAQuietExec64:  Error 0x80070001: CAQuietExec64 Failed
CustomAction InstallHFSRequiredWindowsFeatures returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)
Action ended 8:51:12: InstallExecute. Return value 3.
MSI (s) (EC:B4) [08:51:12:439]: Note: 1: 2265 2:  3: -2147287035

Esse problema ocorrerá se você tentar instalar o agente de sincronização em um controlador de domínio do Active Directory em que o proprietário da função PDC esteja em uma versão do sistema operacional Windows Server 2008 R2 ou anterior.

Para resolver, transfira a função de PDC para outro controlador de domínio em execução no Windows Server 2012 R2 ou mais recente e, em seguida, instale a sincronização.

O acesso a um volume no Windows Server 2012 R2 falha com o erro: O parâmetro está incorreto

Depois de criar um ponto de extremidade de servidor no Windows Server 2012 R2, o seguinte erro ocorrerá ao acessar o volume:

letra da unidade:\ não está acessível.
O parâmetro está incorreto.

Para resolver esse problema, instale o KB2919355 e reinicie o servidor. Se esta atualização não puder ser instalada porque uma atualização posterior já está instalada, vá para o Windows Update, instale as atualizações mais recentes para o Windows Server 2012 R2 e reinicie o servidor.

Registros do servidor

Solucionar problemas de falhas de registro do servidor

Se o registro do servidor falhar, abra o arquivo AfsSrvRegistration*.log localizado em %LocalAppData%\Temp e pesquise "ErrorMessage" para obter os detalhes do erro.

Se você não conseguir identificar a causa com base na mensagem de erro, use o Debug-StorageSyncServer cmdlet para ajudar a diagnosticar se o registro do servidor falha devido a um problema de rede ou certificado do servidor.

Para executar o diagnóstico no servidor, execute os seguintes comandos do PowerShell:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -Diagnose

Para testar a conectividade de rede no servidor, execute os seguintes comandos do PowerShell:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -TestNetworkConnectivity

O registro do servidor usando o Register-AzStorageSyncServer cmdlet falha com o erro: Falha catastrófica (0x8000FFFF)

Um registro de servidor usando o Register-AzStorageSyncServer cmdlet falha com o seguinte erro:

Falha catastrófica (0x8000FFFF (E_UNEXPECTED)) "Nenhuma identidade gerenciada atribuída pelo sistema foi encontrada para este recurso"

Esse problema ocorre quando o agente de Sincronização de Arquivos do Azure é atualizado da versão 17.x para a 18.x e o valor do ServerType Registro é definido como um valor inesperado.

Para resolver esse problema, exclua o valor do ServerType Registro executando os seguintes comandos em um prompt de comando com privilégios elevados:

reg delete HKLM\SOFTWARE\Microsoft\Azure\StorageSync /v ServerType /f  
net stop filesyncsvc  
net start filesyncsvc  

Depois que o valor do ServerType Registro for excluído, repita o registro do servidor.

O Registro de Servidor não lista todas as Assinaturas do Azure

Ao registrar um servidor usando o ServerRegistration.exe, as assinaturas estão ausentes quando você seleciona a lista suspensa Assinatura do Azure.

Esse problema ocorre porque ServerRegistration.exe recuperará apenas assinaturas dos cinco primeiros locatários do Microsoft Entra.

Para aumentar o limite de locatário de Registro de Servidor no servidor, crie um valor DWORD chamado ServerRegistrationTenantLimit em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync com um valor maior que 5.

Você também pode solucionar esse problema usando os seguintes comandos do PowerShell para registrar o servidor:

Connect-AzAccount -Subscription "<guid>" -Tenant "<guid>"
Register-AzStorageSyncServer -ResourceGroupName "<your-resource-group-name>" -StorageSyncServiceName "<your-storage-sync-service-name>"

O registro do servidor exibe a seguinte mensagem: "Este servidor já está registrado"

Captura de tela que mostra a caixa de diálogo Registro do servidor com a mensagem de erro 'o servidor já está registrado'.

Esta mensagem é exibida se o servidor foi registrado anteriormente com um Serviço de Sincronização de Armazenamento. Para cancelar o registro do servidor com o Serviço de Sincronização de Armazenamento atual e registrar com o novo Serviço de Sincronização de Armazenamento, siga as etapas para Cancelar o registro de um servidor com uma Sincronização de arquivos do Azure.

Se o servidor não estiver listado em Servidores registrados no Serviço de Sincronização de Armazenamento, no servidor que você deseja cancelar o registro, execute os seguintes comandos do PowerShell:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Reset-StorageSyncServer

Observação

Se o servidor fizer parte de um cluster, use o Reset-StorageSyncServer -CleanClusterRegistration parâmetro para remover o servidor dos detalhes de registro do cluster da Sincronização de Arquivos do Azure.

Ao registrar um servidor, obtenho várias respostas de "sites não confiáveis". Por quê?

Esse erro ocorre porque a política Segurança reforçada do Internet Explorer está habilitada durante o registro do servidor. Para obter mais informações sobre como desabilitar corretamente a política Segurança aprimorada do Internet Explorer, consulte Preparar o Windows Server para usar com o Azure File Sync e Como implantar o Azure File Sync.

O servidor não está listado em servidores registrados no portal do Azure

Se um servidor não estiver listado em Servidores registrados para um Serviço de Sincronização de Armazenamento:

  1. Entre no servidor que você deseja registrar.
  2. Abra o Explorador de Arquivos e vá para o diretório de instalação do Agente de Sincronização de Armazenamento (o local padrão é C:\Arquivos de Programas\Azure\StorageSyncAgent).
  3. Execute ServerRegistration.exe e conclua o assistente para registrar o servidor em um Serviço de Sincronização de Armazenamento.

Confira também

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.