次の方法で共有

チュートリアル: サイトまたはドキュメント ライブラリのトリミング ジョブをキューに入れます

  • [アーティクル]

このチュートリアルでは、PowerShell を使用してトリミング ジョブをキューに入れる方法で、サイトまたはライブラリから既存のバージョンをトリミングする方法について説明します。 次の方法について学習します。

  • サイトからバージョンをトリミングするためにジョブをキューに入れます。
  • ライブラリからバージョンをトリミングするためにジョブをキューに入れます。
  • トリミング ジョブの進行状況を確認します。
  • 進行中のトリミング ジョブを停止します。

開始する前に

トリミング ジョブによって削除されたバージョンは完全に削除され、ごみ箱から回復することはできません。 次のアクションを実行して準備することをお勧めします。

  • 要件を満たすために必要なトリミング アクションとスコープの決定に役立つ、organizationの回復目標とバージョン ストレージ使用量クォータのターゲットを確認します。

  • 必要に応じて、 影響分析を実行 してトリミングの影響を把握します。

  • バージョンの削除 のスコープを 決定します。 サイト内のすべてのドキュメント ライブラリまたは特定のドキュメント ライブラリの古いファイル バージョンを削除するジョブを作成できます。

  • 既存のバージョンに適用する トリミング モード を決定します。 バージョンの有効期間、カウント制限、または自動アルゴリズムに基づいて削除を選択できます。

サイト上のバージョンをトリミングするためにジョブをキューに入れます

New-SPOSiteFileVersionBatchDeleteJob PowerShell コマンドを使用して、サイト コレクション内のすべてのドキュメント ライブラリのバージョンをトリミングするジョブをキューに登録できます。

  • バージョンの削除に適用する年齢基準を指定するには、 <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

ドキュメント ライブラリのバージョンをトリミングするためにジョブをキューに入れます

New-SPOListFileVersionBatchDeleteJob PowerShell コマンドを使用して、サイト コレクション内の特定のドキュメント ライブラリのバージョンをトリミングするためにジョブをキューに入れます。

  • バージョンの削除に適用する年齢基準を指定するには、 <DeleteBeforeDays> パラメーターを使用します。 指定した日より古いバージョンは、今後の日数で非同期的にバッチ処理されます。
  • <MajorVersionLimit>を使用して、格納するメジャー バージョンの数制限を指定します。 指定された数を超える最も古いバージョンは、今後数日間にバッチで非同期的に削除されます。
  • <Automatic> パラメーターを使用して、既存のファイル バージョンに自動設定トリミング ロジックを適用します。

例: サイト上の 1 つのライブラリの年齢に基づいてバージョンをトリミングするジョブをキューに入れます

サイト コレクションのドキュメント ライブラリ 'Documents' で 360 日を超えるバージョンを削除するには、 https://contoso.sharepoint.com。

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

トリミング ジョブの進行状況を追跡する

トリミング ジョブの進行状況は、 Get-SPOSiteFileVersionBatchDeleteJobProgress コマンドレットを使用して追跡できます。

次の例では、コマンドレットは、 のトリミング ジョブの進行状況を報告します。 https://contoso.sharepoint.com/sites/site1

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

進行中のトリミング ジョブを停止する

必要に応じて、進行中のトリミング ジョブを取り消すことができます。 コマンドレットが正常に実行されると、進行中のジョブは停止され、それ以上の削除は行われません。

注:

トリミング ジョブを停止しても、既に削除されているバージョンは元に戻りません。

例: サイト トリミング ジョブを停止する

サイト コレクションの追加のバージョントリミングから進行中のトリミング ジョブを停止するには、次の https://contoso.sharepoint.com/sites/site1。

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

例: ライブラリトリミングジョブを停止する

サイト コレクションのドキュメント ライブラリ 'Documents' で進行中のトリミング ジョブを追加のバージョン トリミングから停止するには、次の https://contoso.sharepoint.com/sites/site1。

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