教學課程:將網站或文檔庫的修剪作業排入佇列
在本教學課程中,您將瞭解如何使用PowerShell將修剪作業排入佇列,以修剪網站或文檔庫中的現有版本。 您將瞭解如何:
- 將作業排入佇列,以從月臺修剪版本。
- 將作業排入佇列,以從連結庫修剪版本。
- 檢查修剪作業的進度。
- 停止進行中的修剪作業。
開始之前
修剪作業所刪除的版本會永久刪除,而且無法從回收站復原。 建議您執行下列動作來進行準備:
檢閱組織的 復原目標 和 版本記憶體使用量配額目標 ,以協助判斷符合需求所需的修剪動作和範圍。
如有需要, 請執行影響分析 以瞭解修剪影響。
判斷版本刪除 的範圍 。 您可以建立作業來刪除網站或特定文件庫中所有文件庫的舊檔案版本。
決定您想要在現有版本上套用的 修剪模式 。 您可以根據版本存留期、計數限制或根據自動演演算法選擇刪除。
將工作排入佇列以修剪網站上的版本
您可以使用 PowerShell 命令將作業排入佇列,以修剪網站集合中所有文檔庫的 New-SPOSiteFileVersionBatchDeleteJob
版本。
- 使用 參數
<DeleteBeforeDays>
來指定您想要套用以刪除版本的年齡準則。 超過指定天數的版本會在未來幾天以異步方式以批次方式刪除。 -
<MajorVersionLimit>
使用 來指定要儲存的主要版本計數限制。 超過指定計數的最舊版本會在未來幾天以異步方式以批次方式刪除。 - 使用 參數,
<Automatic>
在現有的檔案版本上套用自動設定修剪邏輯。
範例:將工作排入佇列,以根據站臺上所有文檔庫的存留期來修剪版本
在下列範例中,此作業會排入佇列,以修剪網站集合 https://contoso.sharepoint.com/sites/site1
中所有文檔庫的 180 天以上版本。
New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -DeleteBeforeDays 180
範例:將作業排入佇列,以修剪超過站臺上指定計數限制的最舊版本
在下列範例中,作業會排入佇列,以修剪網站集合 https://contoso.sharepoint.com/sites/site1
中所有文檔庫中超過 100 個主要版本計數限制的最舊版本。
New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0
範例:根據站臺上的自動邏輯將作業排入佇列以修剪版本
在下列範例中,作業會排入佇列,以根據網站集合 https://contoso.sharepoint.com/sites/site1
中所有文檔庫的自動演算法來修剪版本。
New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -Automatic
將作業排入佇列以修剪文檔庫上的版本
您可以使用PowerShell命令將作業排入佇列,以修剪網站集合中特定文件庫的 New-SPOListFileVersionBatchDeleteJob
版本。
- 使用 參數
<DeleteBeforeDays>
來指定您想要套用以刪除版本的年齡準則。 超過指定天數的版本會在未來幾天以異步方式以批次方式執行。 -
<MajorVersionLimit>
使用 來指定要儲存的主要版本計數限制。 超過指定計數的最舊版本會在未來幾天以異步方式以批次方式刪除。 - 使用 參數,
<Automatic>
在現有的檔案版本上套用自動設定修剪邏輯。
範例:將作業排入佇列,以根據站臺上單一文檔庫上的存留期來修剪版本
若要刪除網站集合 https://contoso.sharepoint.com
中文檔庫 『Documents』 中早於 360 天的版本。
New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com -List "Documents" -DeleteBeforeDays 360
追蹤修剪作業的進度
您可以使用 Cmdlet 來追蹤修剪作業的 Get-SPOSiteFileVersionBatchDeleteJobProgress
進度。
在下列範例中, Cmdlet 會報告修剪作業的進度 https://contoso.sharepoint.com/sites/site1
Get-SPOSiteFileVersionBatchDeleteJobProgress -Identity https://contoso.sharepoint.com/sites/site1
停止進行中的修剪作業
如有需要,您可以取消進行中的修剪作業。 一旦 Cmdlet 成功執行,進行中的作業就會停止,而且不會發生任何進一步的刪除。
注意事項
停止修剪作業不會還原已刪除的版本。
範例:停止網站修剪作業
若要停止進行中的修剪作業,請在網站集合 https://contoso.sharepoint.com/sites/site1
上進行其他版本修剪:
Remove-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1
範例:停止連結庫修剪作業
若要在網站集合 https://contoso.sharepoint.com/sites/site1
的文檔庫 『Documents』 中停止進行中的修剪作業,
Remove-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents"