Como Auditar as Versões do Aplicativo de Sincronização do OneDrive em Todo o Tenant

Como administrador de TI, você precisa saber quais versões do aplicativo de sincronização do OneDrive estão em execução em cada dispositivo do seu tenant. Clientes de sincronização desatualizados podem causar falhas de sincronização, recursos ausentes do Arquivos Sob Demanda e lacunas de conformidade. Este artigo explica como usar o centro de administração do Microsoft 365, o Microsoft Graph PowerShell e o centro de administração de aplicativos do Microsoft 365 para auditar as versões do aplicativo de sincronização em toda a organização. Você aprenderá as etapas exatas para gerar um relatório de versões, interpretar os dados e identificar dispositivos que precisam de atualizações.

O que a Auditoria de Versão do Aplicativo de Sincronização do OneDrive Abrange

O aplicativo de sincronização do OneDrive é atualizado automaticamente no Windows e macOS quando o dispositivo está conectado à internet e o aplicativo de sincronização está em execução. No entanto, alguns dispositivos podem ficar desatualizados devido a períodos offline, políticas de grupo que bloqueiam atualizações ou ferramentas de gerenciamento de terceiros que adiam as atualizações. Como administrador, você não pode forçar uma atualização do aplicativo de sincronização a partir da nuvem. Em vez disso, você deve identificar clientes desatualizados e usar sua ferramenta de gerenciamento de dispositivos, como Microsoft Intune ou Política de Grupo, para aplicar a atualização.

A auditoria depende dos dados de telemetria que o aplicativo de sincronização envia para o Microsoft 365. Cada cliente de sincronização relata seu número de versão, ID do dispositivo, sistema operacional e carimbo de data/hora da última sincronização bem-sucedida. Esses dados estão disponíveis por meio de três canais: os relatórios do centro de administração do Microsoft 365, o Microsoft Graph PowerShell e o centro de administração de aplicativos do Microsoft 365. Cada canal oferece um nível diferente de detalhe e capacidade de exportação.

Numeração de Versões e Canais de Lançamento

As versões do aplicativo de sincronização do OneDrive seguem o formato XX.YYY.ZZ.WWWW, por exemplo 24.001.0102.0003. Os dois primeiros dígitos indicam o ano e o mês da compilação. A Microsoft lança atualizações por meio de três canais: Production (estável), Insiders (acesso antecipado) e Enterprise (adiado). O canal Enterprise recebe atualizações aproximadamente 60 dias após o canal Production. Você deve comparar as versões relatadas com o lançamento mais recente do Production listado no roteiro do Microsoft 365 ou na página de notas de versão do OneDrive.

Etapas para Gerar um Relatório de Versão do Aplicativo de Sincronização em Todo o Tenant

Siga estes três métodos para coletar dados de versão. Comece com o relatório do centro de administração para uma visão geral rápida. Use o PowerShell para uma exportação completa. Use o centro de administração de aplicativos do Microsoft 365 para solucionar problemas por dispositivo.

Método 1: Relatório do Centro de Administração do Microsoft 365

1. Abra o centro de administração do Microsoft 365
   Acesse https://admin.microsoft.com e faça login com uma conta que tenha a função de Administrador Global ou Leitor de Relatórios.
2. Navegue até o relatório de uso do OneDrive
   No painel de navegação esquerdo, selecione Relatórios e depois Uso. Na seção Exibir relatórios por produto, selecione OneDrive.
3. Abra a guia Versões do aplicativo de sincronização
   Na página do relatório de uso do OneDrive, clique na guia Versões do aplicativo de sincronização. A tabela mostra cada versão do aplicativo de sincronização detectada e o número de dispositivos que usam essa versão.
4. Exporte o relatório
   Clique no botão Exportar na parte superior da tabela para baixar um arquivo CSV contendo o resumo das versões. Este arquivo inclui apenas números de versão e contagens de dispositivos, não identificadores individuais de dispositivos.

Método 2: Microsoft Graph PowerShell

1. Instale o módulo Microsoft Graph PowerShell
   Abra o Windows PowerShell como administrador e execute Install-Module Microsoft.Graph -Scope CurrentUser. Se você já tiver o módulo, execute Update-Module Microsoft.Graph.
2. Conecte-se ao Microsoft Graph com os escopos corretos
   Execute Connect-MgGraph -Scopes "Report.Read.All", "Device.Read.All". Faça login com uma conta de Administrador Global ou Leitor de Relatórios.
3. Execute o cmdlet Get-OneDriveSyncClientVersion
   Este cmdlet faz parte do endpoint de relatórios Beta do Microsoft Graph. Execute o seguinte comando:
   Get-MgReportOneDriveUsageAccountDetail -Period D90 | Export-Csv -Path "C:\Reports\OneDriveSyncVersions.csv" -NoTypeInformation
   Substitua D90 por D7, D30 ou D90, dependendo do período de tempo que você deseja auditar.
4. Abra o arquivo CSV exportado
   Abra o arquivo CSV no Excel ou em um editor de texto. O arquivo contém colunas incluindo ID do Dispositivo, Versão do Aplicativo de Sincronização, Data da Última Sincronização e Sistema Operacional. Filtre a coluna Versão do Aplicativo de Sincronização para identificar dispositivos executando versões mais antigas que o lançamento mais recente do Production.

Método 3: Centro de Administração de Aplicativos do Microsoft 365

1. Abra o centro de administração de aplicativos do Microsoft 365
   Acesse https://config.office.com e faça login com uma conta de Administrador Global.
2. Navegue até Integridade da Sincronização do OneDrive
   No painel esquerdo, selecione Integridade e depois Integridade da Sincronização do OneDrive. Este painel mostra uma lista de dispositivos que sincronizaram nos últimos 28 dias.
3. Revise os detalhes do dispositivo
   Clique em qualquer linha de dispositivo para expandir os detalhes. O campo Versão do aplicativo de sincronização mostra a versão exata instalada naquele dispositivo. Você também pode ver o carimbo de data/hora da última sincronização, erros de sincronização e a plataforma do dispositivo.
4. Exporte a lista de dispositivos
   Clique no botão Exportar na parte superior da lista de dispositivos para baixar um arquivo CSV com todos os dispositivos relatados e suas versões do aplicativo de sincronização.

Problemas Comuns ao Auditar Versões do Aplicativo de Sincronização

A Guia Versões do Aplicativo de Sincronização Não Mostra Dados

Se a guia Versões do aplicativo de sincronização no centro de administração do Microsoft 365 estiver vazia ou mostrar zero dispositivos, o tenant pode ter menos de 10 clientes de sincronização ativos. A Microsoft relata apenas dados agregados para tenants com 10 ou mais dispositivos. Para tenants menores, use o PowerShell ou o centro de administração de aplicativos do Microsoft 365 para ver dados individuais dos dispositivos.

O PowerShell Retorna um Arquivo CSV Vazio

O cmdlet Get-MgReportOneDriveUsageAccountDetail requer o escopo de permissão Report.Read.All. Se o arquivo CSV estiver vazio ou contiver apenas cabeçalhos, reconecte-se com o escopo correto usando Connect-MgGraph -Scopes "Report.Read.All". Verifique também se a conta usada tem a função de Leitor de Relatórios ou Administrador Global.

Dispositivos Mostram uma Versão Mais Antiga do que o Esperado

Um dispositivo pode relatar uma versão mais antiga se o aplicativo de sincronização não for executado por vários dias. O aplicativo de sincronização verifica atualizações apenas quando está em execução. Se o dispositivo estava offline ou o aplicativo de sincronização foi pausado, os dados de versão no relatório refletem a última vez que o aplicativo sincronizou com sucesso. Instrua o usuário a abrir o OneDrive e aguardar a conclusão da sincronização, depois execute a auditoria novamente após 24 horas.

Relatório do Centro de Administração vs PowerShell vs Centro de Administração de Aplicativos do Microsoft 365

Item	Relatório do Centro de Administração	Exportação PowerShell	Centro de Administração de Aplicativos do Microsoft 365
Granularidade dos dados	Apenas contagens agregadas de versões	Versão por dispositivo, ID do dispositivo, última sincronização	Versão por dispositivo, status de sincronização, erros
Formato de exportação	CSV com versão e contagem	CSV com detalhes completos do dispositivo	CSV com detalhes do dispositivo
Requisito mínimo de dispositivos	10 dispositivos ativos	Nenhum mínimo	1 dispositivo ativo
Função necessária	Leitor de Relatórios ou Administrador Global	Leitor de Relatórios ou Administrador Global	Administrador Global

Use o relatório do centro de administração para uma verificação rápida de integridade. Use o PowerShell quando precisar de uma exportação completa para conformidade ou rastreamento de atualizações. Use o centro de administração de aplicativos do Microsoft 365 quando precisar solucionar problemas de um dispositivo específico que mostra erros de sincronização ou uma versão desatualizada.

Agora você pode gerar uma auditoria em todo o tenant das versões do aplicativo de sincronização do OneDrive usando o relatório do centro de administração do Microsoft 365, a exportação do Microsoft Graph PowerShell ou o centro de administração de aplicativos do Microsoft 365. Após coletar o relatório, filtre a coluna de versão para encontrar dispositivos executando compilações mais antigas que o lançamento mais recente do Production. Para cada dispositivo desatualizado, use o Microsoft Intune ou a Política de Grupo para implantar a versão atual do aplicativo de sincronização. Como etapa avançada, agende o script PowerShell mensalmente e salve a saída CSV em uma biblioteca de documentos do SharePoint para rastreamento do histórico de versões.