M365Con 2027 – conferência online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Como reduzir as versões de arquivos do SharePoint com limites de contagem: o que realmente significa MajorWithMinorVersionsLimit

By ·

Um trabalho de redução com -MajorVersionLimit 100 e -MajorWithMinorVersionsLimit 5 manteve todas as versões secundárias. Veja como a Microsoft descreve os dois limites, como executar uma redução segura e o que continua pouco claro.

Automatically translated with AI from the original post. Read the English original

Um administrador do SharePoint queria reduzir o armazenamento removendo versões de arquivos em todos os sites. Ele executou um script que lia as URLs dos sites de um arquivo CSV e chamava New-SPOSiteFileVersionBatchDeleteJob com -MajorVersionLimit 100 e -MajorWithMinorVersionsLimit 5. A expectativa era manter as últimas 100 versões principais e as últimas 5 versões secundárias de cada versão principal. O que aconteceu: as versões principais foram reduzidas, mas todas as versões secundárias das versões principais restantes permaneceram.

Pontos-chave

  • A Microsoft Learn descreve o -MajorWithMinorVersionsLimit como o número de versões principais para as quais todas as versões secundárias são mantidas, e não como um limite para a quantidade de versões secundárias.
  • Os dois parâmetros de contagem devem ser informados juntos, e o tutorial do Learn usa -MajorWithMinorVersionsLimit 0 quando somente as versões principais devem ser contadas.
  • As versões removidas são excluídas permanentemente e ignoram a lixeira, então execute primeiro a análise de simulação (what-if) e teste em um único site.
  • Os trabalhos de redução são executados em segundo plano, em lotes, nos dias seguintes, e você pode verificar ou cancelar esses trabalhos com os cmdlets de progresso e de remoção.
  • O Learn não informa como são tratados os arquivos que possuem apenas versões secundárias (por exemplo, 0.192), então verifique esse caso em uma biblioteca de teste.

Essa pergunta foi publicada no Microsoft Community Hub em fevereiro de 2026 e não tem resposta. Este artigo não afirma resolvê-la. Ele mostra o que o Microsoft Learn diz sobre os dois parâmetros, oferece uma forma cuidadosa de executar uma redução e indica os pontos em que a documentação e a discussão deixam lacunas. Não se trata de um procedimento oficial da Microsoft.

O que os dois parâmetros fazem, segundo a documentação

A página do Learn "Reduzir versões existentes" apresenta o comando com limite de contagem assim: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. O texto de marcação do segundo parâmetro diz "número de versões principais para as quais todas as versões secundárias serão mantidas". A página do Learn sobre limites de versão de bibliotecas usa praticamente as mesmas palavras para o Set-SPOListVersionPolicy: o número de versões principais para as quais todas as versões secundárias são mantidas.

A página também informa que o modo manual de limite de contagem exclui as versões mais antigas que excedam o limite especificado.

Mais três detalhes da documentação:

  1. Na referência do cmdlet, a sintaxe com limite de contagem exige tanto -MajorVersionLimit quanto -MajorWithMinorVersionsLimit. Cada página diz que é preciso informar também o outro.
  2. O tutorial do Learn "Enfileirar um trabalho de redução" mostra -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 e o descreve como a manutenção de 100 versões principais.
  3. O exemplo da referência do cmdlet usa -MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.

Na minha leitura, o segundo número não significa "quantas versões secundárias manter". Ele se aproxima mais de "para quantas versões principais você quer manter todas as versões secundárias". Essa leitura difere do que o autor da pergunta esperava. Ela também não explica totalmente o resultado dele. Com um valor de 5, você esperaria que todas as versões secundárias sobrevivessem apenas por um número limitado de versões principais, e não por cada versão principal retida. As páginas da Microsoft não descrevem o padrão exato, então não consigo dizer se ele observou um atraso, uma regra diferente ou um bug. Trate isso como uma questão em aberto.

Passo 1: Decida qual modo de limpeza você precisa

O Learn descreve três modos de limpeza para versões existentes:

  • Idade: -DeleteBeforeDays <dias> exclui as versões mais antigas que o número de dias informado.
  • Limite de quantidade: -MajorVersionLimit e -MajorWithMinorVersionsLimit, conforme descrito acima.
  • Automático: -Automatic aplica a lógica da configuração de versão Automática às versões existentes.

A página do Learn sobre limites do histórico de versões recomenda a configuração Automática para um armazenamento de versões otimizado. Ela diz que a configuração Automática combina o valor de recuperação do histórico de versões com menor uso de armazenamento, sem que você precise adivinhar limites de quantidade ou de idade. A página sobre armazenamento de versões do plano diz que a configuração Automática mantém as versões criadas nos primeiros 30 dias (dentro de um limite de 500 versões) e, à medida que envelhecem, as reduz para versões horárias, diárias e semanais.

Para a limpeza baseada em idade, o Learn lista dois limites. O trabalho não exclui versões criadas nos últimos 30 dias, então a entrada precisa ter pelo menos 30 dias. Ele também sempre exclui todas as versões criadas antes de 1º de janeiro de 2023, então o número de dias escolhido precisa resultar em uma data posterior a essa. Verifique a página atual antes de confiar nesses dois pontos.

Passo 2: Gere o relatório e execute a análise de simulação

A página de limpeza do Learn recomenda executar uma análise de simulação (what-if) antes da limpeza (o tutorial de enfileirar um trabalho a chama de opcional). Os tutoriais descrevem um relatório de uso de armazenamento de versões para o site ou a biblioteca, que você baixa como arquivo CSV. Em seguida, você executa um script sobre o relatório com o PowerShell 7. No caso de limite de quantidade, o script de simulação do tutorial recebe -ImportPath, -ExportPath e -MajorVersionLimit. Ele não recebe um limite de versões secundárias. Por isso, o resultado da simulação para limites de quantidade modela apenas o limite de versões principais.

As páginas dos tutoriais não informam o cmdlet que cria o relatório, então siga o tutorial do Learn para essa etapa. O Learn diz que um trabalho de limpeza pode levar alguns dias, dependendo do tamanho da biblioteca. O tutorial de simulação não informa duração.

Passo 3: Enfileire o trabalho primeiro em um site

Conecte-se como Administrador do SharePoint com o SharePoint Online Management Shell atual e, em seguida, enfileire um trabalho para um site de teste:

``powershell New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``

Para uma biblioteca, use a variante de biblioteca:

``powershell New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``

O Learn alerta que as versões excluídas dessa forma são removidas permanentemente e não vão para a lixeira. A referência do cmdlet também lista -WhatIf e -Confirm como parâmetros. A referência descreve -WhatIf apenas como a exibição do que aconteceria se o cmdlet fosse executado, sem detalhes sobre sua saída para esses cmdlets. Portanto, não o trate como substituto da análise de simulação baseada em relatório.

Passo 4: Acompanhe o trabalho

Os trabalhos de limpeza são assíncronos. De acordo com o Learn, a exclusão acontece em lotes ao longo dos próximos dias, e o volume, a integridade do serviço e a carga de trabalho da farm afetam o tempo de execução. Verifique um trabalho em nível de site com:

``powershell Get-SPOSiteFileVersionBatchDeleteJobProgress -Identity https://contoso.sharepoint.com/sites/site1 ``

Para um trabalho de biblioteca, a página de limpeza do Learn lista Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <nome>. Para interromper um trabalho, use Remove-SPOSiteFileVersionBatchDeleteJob ou Remove-SPOListFileVersionBatchDeleteJob. Cancelar interrompe as exclusões futuras, mas não restaura as versões que já foram excluídas.

Não espere que o relatório de armazenamento mude imediatamente. A página do Learn sobre limites de armazenamento de sites diz que o uso de armazenamento não inclui alterações das últimas 24 a 48 horas.

Etapa 5: Defina limites para novas versões

Uma tarefa de redução só processa versões que existem hoje. Para controlar versões futuras, defina a política de versões no site ou na biblioteca:

  • Site: Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $true para limites automáticos. O Learn lista -ApplyToNewDocumentLibraries e -ApplyToExistingDocumentLibraries para escolher o escopo.
  • Biblioteca: Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.

Definir uma política de site ou de biblioteca não reduz versões que já existem, então enfileire uma tarefa de redução para elas. Alterações em bibliotecas existentes são processadas em um job em segundo plano que, segundo o Learn, pode levar até 24 horas. O Learn acrescenta que, ao reduzir o limite de quantidade em uma biblioteca, as versões existentes acima do novo limite são removidas gradualmente, até 20 por nova versão criada. A interface do centro de administração não aceita menos de 100 versões principais nem uma expiração menor que 30 dias. Segundo o Learn, valores menores são possíveis por meio de APIs públicas, mas não são recomendados, pois podem causar perda de dados não intencional.

Etapa 6: Redução em todo o locatário

O Learn lista cmdlets em nível de locatário, como New-SPOTenantApplyFileVersionPolicyJob (com -CollectVersionData, -TrimVersions e -SetVersionPolicy). Eles estão em prévia pública, exigem uma licença do SharePoint Advanced Management ou uma licença do Copilot e excluem sites somente leitura, bloqueados e arquivados. Apenas um job em nível de locatário pode ser executado por vez. Se você gerencia muitos sites, compare essa abordagem com um loop de CSV como o descrito na discussão.

O que continua não claro

  • Arquivos somente com versões secundárias: O autor perguntou sobre arquivos que nunca foram publicados como versão principal e têm centenas de versões secundárias, como 0.192. O Learn não explica como a redução por limite de quantidade trata esses casos. Crie uma biblioteca de teste, adicione um arquivo desses e execute um job pequeno antes de mexer em produção.
  • Divergência no resultado: A observação do autor de que todas as versões secundárias de cada versão principal mantida permaneceram não é explicada pelas páginas que eu li.
  • Retenção: A página do Learn sobre redução se refere a um FAQ para versões sob políticas de retenção ou retenções do eDiscovery. Ela não descreve o comportamento na própria página.

Relacionados

Fontes

Entities in this article

SharePoint Intelligent versioning (SharePoint) SharePoint document libraries SharePoint Advanced Management

Related articles

RSS