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 ajuda você a solucionar problemas que você pode encontrar 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 experimentar 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 ocorre se a versão do agente de Sincronização de Arquivos do Azure instalada no momento for anterior à v16.2 e o processo deLogman.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 do LogMan e selecione Encerrar tarefa. Repita essa etapa até que todos os processos do LogMan sejam interrompidos e a atualização do agente seja concluída com êxito.

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:\Arquivos de Programas\Azure\StorageSyncAgent\InstallerLog.

O nome do arquivo de log para instalações do agente usando o pacote MSI é AfsAgentInstall. O nome do arquivo de log para instalações do 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 ERROR_NO_SYSTEM_RESOURCES e código de erro 0x800705AA

A instalação do agente falhou devido a recursos insuficientes do sistema. Para resolver esse problema, libere memória no servidor e repita a instalação.

Falha na instalação do agente: o Assistente de Configuração do Agente de Sincronização de Armazenamento terminou 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 ocorrerá 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 somente scripts assinados". Todos os scripts incluídos no agente de 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 de política de grupo 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.

Falha na instalação do agente 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 KB2919355 e reinicie o servidor. Se essa atualização não puder ser instalada porque uma atualização posterior já está instalada, acesse o Windows Update, instale as atualizações mais recentes do Windows Server 2012 R2 e reinicie o servidor.

Instalação do agente por meio da extensão do Azure Arc

Para saber mais sobre como instalar o Agente de Sincronização de Arquivos do Azure para Windows, consulte Instalar e gerenciar a extensão do agente de Sincronização de Arquivos do Azure em servidores Windows habilitados para Azure Arc.

Solucionar problemas de falha de instalação

1. Navegue até o seu Servidor Arc no portal do Azure.
2. Vá para a aba Extensões do servidor.
3. Localize AzureFileSyncAgentExtension e selecione Exibir Detalhes na coluna Status .
4. Examine o campo Mensagem de Erro para obter informações detalhadas sobre a causa da falha na implantação da extensão.

Referência e correção de código de erro

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 ServerRegistration.exe, as assinaturas não aparecem quando você seleciona o menu suspenso 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 não lista todos os grupos de recursos

Ao registrar um servidor usando ServerRegistration.exe, alguns grupos de recursos podem estar ausentes quando você seleciona a lista suspensa Grupo de Recursos.

Esse problema ocorre devido a um problema conhecido que foi corrigido no Agente de Sincronização de Arquivos v19.1. Para resolver esse problema, instale a versão mais recente do agente.

O Registro do Servidor exibe a mensagem: "System.Net.Http, Version=4.2.0.0, Culture=neutral, PublicKeyToken=..."

Esse erro ocorre quando o servidor não tem a versão necessária do .NET Framework. O registro do servidor da Sincronização de Arquivos do Azure requer que o .NET Framework 4.7.2 ou uma versão posterior funcione corretamente.

Para resolver o problema, siga estas etapas:

1. Baixe e instale o .NET Framework 4.7.2 ou uma versão posterior.
2. Reinicie o servidor após a instalação.
3. Repita o registro do servidor usando a interface do usuário de registro do servidor ou o PowerShell.

O registro do servidor falha com erro: a operação retornou um código de status inválido 'Não autorizado'

Durante o registro do servidor, você pode encontrar o seguinte erro:

A operação retornou um código de status inválido 'Não autorizado'

Esse problema ocorre devido a um bug no agente de Sincronização de Arquivos do Azure v20. Para contornar esse problema, registre manualmente o servidor executando os seguintes comandos do PowerShell:

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

Depois de concluir o registro manual, verifique se o servidor aparece em servidores registrados no portal do Azure.

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

Essa mensagem com o código de erro 0x80C80064 será exibida se o servidor tiver sido registrado anteriormente em um Serviço de Sincronização de Armazenamento. Para cancelar o registro do servidor do Serviço de Sincronização de Armazenamento atual e, em seguida, registrar-se com um novo Serviço de Sincronização de Armazenamento, conclua as etapas em Cancelar o registro de um servidor com a 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

Quando registro um servidor, vejo várias respostas "site não confiável". Por que?

Esse problema ocorre quando a política de Segurança avançada do Internet Explorer é habilitada durante o registro do servidor. Para obter mais informações sobre como desabilitar corretamente a política de segurança avançada do Internet Explorer , consulte Preparar o Windows Server para usar com a Sincronização de Arquivos do Azure e como implantar a Sincronização de Arquivos do Azure.

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.exee conclua o assistente para registrar o servidor com um Serviço de Sincronização de Armazenamento.

Confira também

• Solucionar problemas de gerenciamento de grupo de sincronização de arquivos do Azure
• Solucionar problemas de erros de sincronização de arquivos do Azure
• Solucionar problemas de hierarquização em nuvem do Sincronização de Arquivos do Azure
• Monitorar a Sincronização de Arquivos do Azure
• Solucionar problemas dos Arquivos do Azure

Entre em contato conosco para obter ajuda

Se você tiver dúvidas, poderá perguntar ao suporte da comunidade do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.