Definir limites de versão para um site

Por padrão, as configurações no nível da organização definem os limites do histórico de versão que são aplicados a todas as novas bibliotecas de documentos criadas em um site. No entanto, para atender a necessidades específicas de conteúdo, os administradores podem optar por definir limites distintos do histórico de versões em sites individuais. Dessa forma, os usuários podem quebrar a herança dos limites da organização em um site individual.

Os limites do histórico de versões para um site individual podem ser gerenciados das seguintes maneiras:

Opção de limites do histórico de versão	Descrição
Aplicar a todas as bibliotecas de documentos novas e existentes em um site:	Para obter uma política de armazenamento de versão consistente para um site, você pode optar por definir um limite para ser aplicado universalmente a todas as bibliotecas do site. Usando essa opção, o limite do histórico de versão definido no nível do site é aplicado a todas as novas bibliotecas de documentos criadas no site e cria uma solicitação em segundo plano para processar de forma assíncrona a atualização em bibliotecas de documentos existentes.
Aplicar somente a novas bibliotecas de documentos criadas em um site:	Para evitar afetar as configurações das bibliotecas existentes, você pode definir um limite de histórico de versão somente para novas bibliotecas. Usando essa opção, os limites do histórico de versão definidos no nível do site são aplicados apenas às novas bibliotecas de documentos criadas no site. Não há alterações feitas nos limites das bibliotecas de documentos existentes ou em bibliotecas que não estão habilitadas para controle de versão no site.
Aplicar a bibliotecas de documentos existentes apenas em um site:	Você pode atualizar os limites apenas em bibliotecas de documentos existentes em um site sem definir uma configuração de histórico de versão no nível do site para novas bibliotecas de documentos. Usar essa opção cria uma solicitação em segundo plano para processar de forma assíncrona a atualização em bibliotecas de documentos existentes, permitindo que as novas bibliotecas de documentos criadas no site herdem os limites do histórico de versão no nível da organização.
Limpar os limites existentes definidos em um site:	Você pode limpar os limites existentes em um site para permitir que novas bibliotecas de documentos criadas no site sigam os limites no nível da organização. Observação: Limpar uma configuração em um Site se aplica apenas a novas bibliotecas de documentos criadas no site e não afeta as configurações em bibliotecas de documentos existentes nem corta versões existentes.

Cenário de exemplo

Veja um exemplo da Contoso, em que os limites de histórico de versão da organização padrão são definidos como configuração automática e nenhum limite de versão é aplicado inicialmente em sites jurídicos e de marketing. Para atender às necessidades de negócios, o administrador pode decidir aplicar a configuração 'Manual' no site jurídico, interrompendo assim a herança do site legal com a configuração de versão padrão da organização.

A seguir está o armazenamento de versões da Contoso:

Comportamento de armazenamento de versão no site de marketing: como nenhum limite foi configurado para o site de marketing, todas as novas bibliotecas de documentos criadas no conjunto de sites de marketing herdam a configuração padrão da organização de automático.
Armazenamento de versão no site jurídico: como o site jurídico tem configurações manuais definidas, todas as novas bibliotecas criadas no site jurídico têm as configurações manuais aplicadas.

Importante

Nível do site Os limites do histórico de versões podem ser definidos usando apenas cmdlets do PowerShell.
Definir limites de histórico de versão no nível do site não corta as versões existentes para atender aos novos limites. Etapas adicionais são necessárias para cortar versões existentes em um site ou biblioteca.
As solicitações para atualizar os limites das bibliotecas existentes são processadas de forma assíncrona por um trabalho em segundo plano, que pode levar até 24 horas para ser processado. Você pode usar o PowerShell para marcar o progresso do trabalho.
O cancelamento de um trabalho em andamento interrompe a atualização em bibliotecas que não foram processadas. Essa ação não reverte a alteração para bibliotecas de documentos em que a atualização de configurações já foi processada.

Gerenciar limites de histórico de versão para um site usando o PowerShell

Siga estas etapas para gerenciar os limites do histórico de versões de um site usando o PowerShell.

Baixe o Shell de Gerenciamento do SharePoint Online mais recente.

Observação

Se você instalou uma versão anterior do Shell de Gerenciamento do SharePoint Online, vá para Adicionar ou remover programas e desinstale Shell de Gerenciamento do SharePoint Online.
Conecte-se ao SharePoint como administrador do SharePoint no Microsoft 365. Para saber como, consulte Introdução ao Shell de Gerenciamento do SharePoint Online.
Execute um dos seguintes comandos para gerenciar os limites do histórico de versões em seu site:

Action	Comando do PowerShell
Exibir os limites do histórico de versões definidos em um site	Get-SPOSite -Identity $siteUrl \| fl Url, EnableAutoExpirationVersionTrim, ExpireVersionsAfterDays, MajorVersionLimit
Definir limites do histórico de versão automática em um site.	Para definir Limites Automáticos do Histórico de Versão para todas as bibliotecas em um site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $true` Anexar `-ApplyToNewDocumentLibraries` parâmetro para aplicar somente a novas bibliotecas de documentos no site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $true` `-ApplyToNewDocumentLibraries` Forneça `-FileTypesForVersionExpiration` um parâmetro com uma matriz de tipos de arquivo e acrescente `-ApplyToNewDocumentLibraries` o parâmetro para aplicar o limite de histórico de versão automático a esses tipos de arquivo em novas bibliotecas de documentos no site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $true` `-ApplyToNewDocumentLibraries` `-FileTypesForVersionExpiration @("<file type 1>", "<file type 2>")` Acrescentar `-ApplyToExistingDocumentLibraries` para se aplicar somente a bibliotecas de documentos existentes em um site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $true` `-ApplyToExistingDocumentLibraries`
Definir limites manuais com parâmetros de contagem e tempo em um site.	Para definir limites manuais com parâmetros de contagem e tempo para todas as bibliotecas em um site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $false` `-MajorVersionLimit <delete major versions exceeding limit>` `-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>` `-ExpireVersionsAfterDays <delete versions exceeding time limit set in days>` Anexar `-ApplyToNewDocumentLibraries` parâmetro para aplicar somente a novas bibliotecas de documentos no site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $false` `-MajorVersionLimit <delete major versions exceeding limit>` `-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>` `-ExpireVersionsAfterDays <delete versions exceeding time limit set in days>` `-ApplyToNewDocumentLibraries` Forneça `-FileTypesForVersionExpiration` um parâmetro com uma matriz de tipos de arquivo e acrescente `-ApplyToNewDocumentLibraries` o parâmetro para aplicar o limite de histórico de versão automático a esses tipos de arquivo em novas bibliotecas de documentos no site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $false` `-MajorVersionLimit <delete major versions exceeding limit>` `-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>` `-ExpireVersionsAfterDays <delete versions exceeding time limit set in days>` `-ApplyToNewDocumentLibraries` `-FileTypesForVersionExpiration @("<file type 1>", "<file type 2>")` Acrescentar `-ApplyToExistingDocumentLibraries` para se aplicar somente a bibliotecas de documentos existentes em um site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $false` `-MajorVersionLimit <delete major versions exceeding limit>` `-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>` `-ExpireVersionsAfterDays <delete versions exceeding time limit set in days>` `-ApplyToExistingDocumentLibraries`
Definir contagem manual sem limite de expiração em um site.	Para definir limites manuais com limites de contagem, defina o `-ExpireVersionsAfterDays` parâmetro como `0:` `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $false` `-MajorVersionLimit <delete major versions exceeding limit>` `-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>` `-ExpireVersionsAfterDays 0` Anexar `-ApplyToNewDocumentLibraries` parâmetro para aplicar somente a novas bibliotecas de documentos no site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $false` `-MajorVersionLimit <delete major versions exceeding limit>` `-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>` `-ExpireVersionsAfterDays 0` `-ApplyToNewDocumentLibraries` Forneça `-FileTypesForVersionExpiration` um parâmetro com uma matriz de tipos de arquivo e acrescente `-ApplyToNewDocumentLibraries` o parâmetro para aplicar o limite de histórico de versão automático a esses tipos de arquivo em novas bibliotecas de documentos no site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $false` `-MajorVersionLimit <delete major versions exceeding limit>` `-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>` `-ExpireVersionsAfterDays 0` `-ApplyToNewDocumentLibraries` `-FileTypesForVersionExpiration @("<file type 1>", "<file type 2>")` Acrescentar `-ApplyToExistingDocumentLibraries` para se aplicar somente a bibliotecas de documentos existentes em um site: `Set-SPOSite -Identity $siteUrl` `-EnableAutoExpirationVersionTrim $false` `-MajorVersionLimit <delete major versions exceeding limit>` `-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>` `-ExpireVersionsAfterDays 0` `-ApplyToExistingDocumentLibraries`
Limpe os limites de histórico de versão de tipo de arquivo definidos em um site para novas bibliotecas de documentos criadas no site.	`Set-SPOSite -Identity $siteUrl` `-RemoveVersionExpirationFileTypeOverride @("<file type 1>", "<file type 2>")` `-ApplyToNewDocumentLibraries`
Limpe os limites de histórico de versões existentes definidos em um site e herde os limites de versão da organização em novas bibliotecas de documentos criadas no site.	`Set-SPOSite -Identity $siteUrl -InheritVersionPolicyFromTenant`
Cancelamento em andamento, trabalho de atualização	`Remove-SPOSiteVersionPolicyJob -Identity $siteUrl`
Iniciar um trabalho de sincronização que atualiza os limites do histórico de versão de todas as bibliotecas de documentos para o mesmo que o site	Para sincronizar todas as partes do limite do histórico de versão: `New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy` Acrescentar `-ExcludeDefaultPolicy` para não sincronizar os limites do histórico de versão padrão: `New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -ExcludeDefaultPolicy` Forneça `-FileTypes` uma matriz de tipos de arquivo para sincronizar apenas a seleção de limites do histórico de versão do tipo de arquivo: `New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -FileTypes @('<file type 1>', '<file type 2>')` Forneça `-FileTypes` uma matriz vazia para sincronizar apenas os limites do histórico de versão padrão: `New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -FileTypes @()`
Cancelar trabalho de sincronização em andamento	`Remove-SPOSiteManageVersionPolicyJobProgress $siteUrl`

Acompanhar o progresso da atualização de configurações em bibliotecas existentes em um site

Os limites de versão em todas as novas bibliotecas criadas no site são aplicados imediatamente. As configurações das bibliotecas existentes são atualizadas de forma assíncrona usando um trabalho em segundo plano. Execute o comando a seguir para acompanhar o progresso do trabalho de atualização de configurações.

Se for um trabalho de atualização iniciado por Set-SPOSite:

Get-SPOSiteVersionPolicyJobProgress -Identity $siteUrl

Se for um trabalho de sincronização iniciado por New-SPOSiteManageVersionPolicyJob:

Get-SPOSiteManageVersionPolicyJobProgress -Identity $siteUrl

A tabela a seguir enumera os vários status de progresso que podem ser relatados ao tentar atualizar as configurações de versão das bibliotecas existentes em um conjunto de sites:

Status	Descrição
NoRequestFound	Não há solicitações no site para definir ou atualizar configurações de versão em bibliotecas de documentos existentes.
Novo	A solicitação de atualização é Nova e ainda não foi processada.
Em andamento	A solicitação de atualização é processada e a solicitação de atualização de configurações está em andamento.
CompleteSuccess	A solicitação de atualização foi concluída com êxito.
CompleteWithFailure	A solicitação de atualização foi concluída, mas a configuração de atualização em algumas bibliotecas de documentos falhou.

Saiba mais:

Tutorial: Gerenciar limites do histórico de versões para uma conta do Site, Biblioteca ou OneDrive
Gerenciar limites de histórico de versão para um site usando Set-SPOSite
Limites de Versão de Tipo de Arquivo
Acompanhar o progresso da solicitação de atualização de configurações de versão para bibliotecas de documentos existentes em um site usando Get-SPOSiteVersionPolicyJobProgress
Cancelar o processamento adicional de atualização de configurações de versão em bibliotecas de documentos existentes no conjunto de sites usando Remove-SPOSiteVersionPolicyJob
Iniciar uma solicitação de sincronização de configurações de versão para bibliotecas de documentos existentes em um site usando New-SPOSiteManageVersionPolicyJob
Acompanhar o progresso das configurações de versão solicitação de sincronização para bibliotecas de documentos existentes em um site usando Get-SPOSiteManageVersionPolicyJobProgress
Cancelar o processamento adicional das configurações de versão sincronizar em bibliotecas de documentos existentes no site usando Remove-SPOSiteManageVersionPolicyJob

Comentários

Esta página foi útil?

Last updated on 2026-08-22