Tutorial: Enfileirar um trabalho de corte para um site ou biblioteca de documentos

Neste tutorial, você aprenderá a cortar versões existentes de um site ou biblioteca enfileirando um trabalho de corte usando o PowerShell. Você aprenderá a:

• Coloque um trabalho na fila para cortar versões de um site.
• Coloque um trabalho na fila para cortar versões de uma biblioteca.
• Verifique o progresso do trabalho de corte.
• Interromper um trabalho de corte em andamento.

Antes de começar

As versões excluídas por um trabalho de corte são excluídas permanentemente e não podem ser recuperadas da lixeira. Recomendamos que você se prepare executando as seguintes ações:

• Analise os objetivos de recuperação da sua organização e as metas de cota de uso de armazenamento de versão para ajudar a determinar a ação de corte e o escopo necessários para atender às suas necessidades.

• Se necessário, execute uma análise de impacto para entender o impacto do corte.

• Determine o escopo da exclusão de versão. É possível criar trabalhos para excluir versões de arquivo antigas para todas as bibliotecas de documentos em um site ou para uma biblioteca de documentos específica.

• Determine o modo de corte que você deseja aplicar nas versões existentes. Você pode optar por excluir com base na idade da versão, no limite de contagem ou com base no algoritmo automático.

Enfileirar um trabalho para cortar versões no site

Você pode enfileirar um trabalho para cortar versões para todas as bibliotecas de documentos no conjunto de sites usando o comando PowerShell New-SPOSiteFileVersionBatchDeleteJob .

• Use o <DeleteBeforeDays> parâmetro para especificar os critérios de idade que você deseja aplicar para excluir versões. Versões anteriores aos dias especificados serão excluídas de forma assíncrona em lotes nos próximos dias.
• Use o <MajorVersionLimit> para especificar o limite de contagem das versões principais a serem armazenadas. As versões mais antigas que excederem a contagem especificada serão excluídas de forma assíncrona em lotes nos próximos dias.
• Use o parâmetro para aplicar a <Automatic> lógica de corte da configuração automática em versões de arquivo existentes.

Exemplo: enfileirar um trabalho para cortar versões com base na idade de todas as bibliotecas em um site

No exemplo a seguir, o trabalho é enfileirado para cortar versões anteriores a 180 dias para todas as bibliotecas de documentos do conjunto https://contoso.sharepoint.com/sites/site1de sites.

New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -DeleteBeforeDays 180 

Exemplo: enfileirar um trabalho para cortar as versões mais antigas que excedem o limite de contagem especificado em um site

No exemplo abaixo, o trabalho é enfileirado para cortar as versões mais antigas que excedem o limite de contagem de 100 versões principais para todas as bibliotecas de documentos no conjunto https://contoso.sharepoint.com/sites/site1de sites.

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

Exemplo: enfileirar um trabalho para cortar versões com base na lógica automática em um site

No exemplo abaixo, o trabalho é enfileirado para cortar versões com base no algoritmo Automático para todas as bibliotecas de documentos no conjunto https://contoso.sharepoint.com/sites/site1de sites.

New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -Automatic 

Enfileirar um trabalho para cortar versões em uma biblioteca de documentos

Você pode enfileirar um trabalho para cortar versões de uma biblioteca de documentos específica no conjunto de sites usando o comando PowerShell New-SPOListFileVersionBatchDeleteJob .

• Use o <DeleteBeforeDays> parâmetro para especificar os critérios de idade que você deseja aplicar para excluir versões. Versões anteriores aos dias especificados serão assíncronas em lotes nos próximos dias.
• Use o <MajorVersionLimit> para especificar o limite de contagem das versões principais a serem armazenadas. As versões mais antigas que excederem a contagem especificada serão excluídas de forma assíncrona em lotes nos próximos dias.
• Use o parâmetro para aplicar a <Automatic> lógica de corte da configuração automática em versões de arquivo existentes.

Exemplo: enfileirar um trabalho para cortar versões com base na idade em uma única biblioteca em um site

Para excluir versões com mais de 360 dias na biblioteca de documentos 'Documentos' no conjunto de https://contoso.sharepoint.comsites.

New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com -List "Documents" -DeleteBeforeDays 360 

Acompanhar o progresso de um trabalho de corte

Você pode acompanhar o progresso do trabalho de corte usando o Get-SPOSiteFileVersionBatchDeleteJobProgress cmdlet.

No exemplo a seguir, o cmdlet relata o progresso do trabalho de corte para https://contoso.sharepoint.com/sites/site1

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

Interromper um trabalho de corte em andamento

Se necessário, você pode cancelar um trabalho de corte em andamento. Depois que o cmdlet for executado com êxito, o trabalho em andamento será interrompido e nenhuma outra exclusão ocorrerá.

Exemplo: Interromper um trabalho de corte de site

Para impedir que um trabalho de corte em andamento seja de corte de versão adicional no conjunto https://contoso.sharepoint.com/sites/site1de sites:

Remove-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1

Exemplo: Interromper um trabalho de corte de biblioteca

Para impedir que um trabalho de corte em andamento seja de corte de versão adicional na biblioteca de documentos 'Documentos' no conjunto https://contoso.sharepoint.com/sites/site1de sites:

Remove-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents"