M365Con 2027 – 無料オンラインカンファレンス · 11–22 Jan 2027 · 120 sessions→ m365con.net

ブログ · Mirko Peters

SharePoint のファイル バージョンを件数制限でトリムする: MajorWithMinorVersionsLimit が実際に意味すること

By ·

-MajorVersionLimit 100 と -MajorWithMinorVersionsLimit 5 を指定してトリム ジョブを実行したところ、すべてのマイナー バージョンが残ってしまいました。本記事では、Microsoft がこの 2 つの制限をどのように説明しているか、安全にトリムを実行する方法、そして依然として不明な点を整理します。

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

SharePoint の管理者が、すべてのサイトのファイルバージョンを削減してストレージ使用量を減らそうとしました。CSV ファイルからサイトの URL を読み込み、New-SPOSiteFileVersionBatchDeleteJob を -MajorVersionLimit 100 と -MajorWithMinorVersionsLimit 5 を指定して実行するスクリプトを使用しました。想定していた動作は、各メジャーバージョンについて最新の 100 個のメジャーバージョンと、それぞれの最新 5 個のマイナーバージョンを保持することでした。しかし実際には、メジャーバージョンは削減されたものの、残ったメジャーバージョンのマイナーバージョンはすべて残ってしまいました。

重要なポイント

  • Microsoft Learn では、-MajorWithMinorVersionsLimit はマイナー バージョンの件数の上限ではなく、すべてのマイナー バージョンを保持するメジャー バージョンの数として説明されています。
  • 2 つの件数パラメーターは必ず一緒に指定する必要があります。また、Learn のチュートリアルでは、メジャー バージョンのみを数えたい場合に -MajorWithMinorVersionsLimit 0 を使用しています。
  • トリムされたバージョンは完全に削除され、ごみ箱もバイパスされます。そのため、まず what-if 分析を実行し、1 つのサイトでテストしてください。
  • トリム ジョブはバックグラウンドで、以降の数日間にわたってバッチ単位で処理されます。進行状況の確認や取り消しは、進行状況用のコマンドレットと Remove 系のコマンドレットで行えます。
  • Learn には、マイナー バージョンのみを持つファイル (例: 0.192) の扱いについては記載がありません。そのため、このケースはテスト用のライブラリで確認してください。

この質問は 2026 年 2 月に Microsoft Community Hub に投稿されたものです。これに対する回答はありません。本記事ではこの問題を解決するとは主張しません。2 つのパラメーターについて Microsoft Learn が説明している内容を示し、トリムを慎重に実行する方法を紹介し、ドキュメントとスレッドの間にあるギャップを明示します。公式な Microsoft の手順ではありません。

2 つのパラメーターがドキュメント上で果たす役割

Learn のページ「「既存のバージョンをトリムする」」では、件数制限のコマンドが次のように記載されています: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>。2 つ目のパラメーターのプレースホルダー テキストは「すべてのマイナー バージョンが保持されるメジャー バージョンの数」です。ライブラリのバージョン制限に関する Learn のページでも、Set-SPOListVersionPolicy について、ほぼ同じ表現が使われています。すべてのマイナー バージョンが保持されるメジャー バージョンの数です。

このページでは、手動の件数制限モードは、指定した件数制限を超える古いバージョンから削除することも説明しています。

ドキュメントには、ほかに次の 3 つの詳細があります:

  1. コマンドレット リファレンスでは、件数制限の構文に -MajorVersionLimit と -MajorWithMinorVersionsLimit の両方が必要とされています。各ページでも、もう一方も必要だと記載されています。
  2. Learn のチュートリアル「「トリム ジョブをキューに入れる」」では -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 が示されており、100 件のメジャー バージョンを保持する例として説明されています。
  3. コマンドレット リファレンスの例では -MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10 が使われています。

2つ目の数値は「保持するマイナー バージョンの数」ではなく、「何個のメジャー バージョンについて、すべてのマイナー バージョンを保持するか」に近いと考えます。この解釈は投稿者が想定していたものとは異なります。また、投稿者の結果を完全に説明できるわけでもありません。値が 5 の場合、マイナー バージョンが残るのは限られた数のメジャー バージョンに対してだけだと想定されますが、実際には保持される各メジャー バージョンについて残っているように見えます。Microsoft のページには正確な動作パターンが記載されていないため、投稿者が遅延を見たのか、別のルールが適用されたのか、あるいはバグなのかは判断できません。この点は未解決として扱います。

手順 1: 必要なトリム モードを決める

Learn では、既存のバージョンに対するトリム モードとして 3 種類が説明されています。

  • 期間: -DeleteBeforeDays <days> を指定すると、指定した日数より古いバージョンが削除されます。
  • 件数制限: 上記のとおり、-MajorVersionLimit と -MajorWithMinorVersionsLimit を使用します。
  • 自動: -Automatic を指定すると、「自動」バージョン設定のロジックが既存のバージョンに適用されます。

バージョン履歴の制限に関する Learn のページでは、バージョン ストレージを最適化するために自動設定を推奨しています。自動設定では、件数や期間の制限を推測して指定しなくても、バージョン履歴による復元の価値とストレージ使用量の削減を両立できると説明されています。プランのバージョン ストレージのページによると、自動設定では最初の 30 日間に作成されたバージョンを保持し(件数の上限は 500 件)、その後は時間の経過とともに 1 時間単位、1 日単位、1 週間単位のバージョンに間引かれます。

期間ベースのトリムについて、Learn では 2 つの制限が挙げられています。ジョブは過去 30 日以内に作成されたバージョンを削除しないため、入力には少なくとも 30 日分が必要です。また、2023 年 1 月 1 日より前に作成されたすべてのバージョンは必ず削除されるため、指定する日数によって、その日付より後の日付になる必要があります。この 2 点に依存する前に、最新のページを確認してください。

手順 2: レポートを生成して what-if 分析を実行する

Learn のトリムのページでは、トリムの前に what-if 分析を実行するよう案内されています(キューにジョブを登録するチュートリアルでは、これは任意とされています)。チュートリアルでは、サイトまたはライブラリのバージョン ストレージ使用状況レポートを作成し、CSV ファイルとしてダウンロードする手順が説明されています。その後、PowerShell 7 でそのレポートに対してスクリプトを実行します。件数制限の場合、チュートリアルの what-if スクリプトは -ImportPath、-ExportPath、-MajorVersionLimit を受け取りますが、マイナー バージョンの制限は受け取りません。そのため、件数制限に対する what-if の結果は、メジャー バージョンの制限のみをモデル化したものになります。

チュートリアルのページでは、レポートを作成するコマンドレットの名前は記載されていないため、この手順は Learn のチュートリアルに従ってください。Learn では、トリム ジョブはライブラリのサイズによっては数日かかる場合があると説明されています。what-if のチュートリアルには所要時間の記載はありません。

手順 3: まず 1 つのサイトでジョブをキューに登録する

現在の SharePoint Online 管理シェルを使用して SharePoint 管理者として接続し、テスト用のサイトを 1 つ指定してジョブを登録します。

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

1 つのライブラリを対象にする場合は、ライブラリ用のバリアントを使用します。

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

Learn では、この方法で削除されたバージョンは完全に削除され、ごみ箱には移動されないと警告されています。コマンドレット リファレンスには、パラメーターとして -WhatIf と -Confirm も記載されています。ただし、リファレンスでは -WhatIf はコマンドレットを実行した場合に何が起こるかを示すものとしてのみ説明されており、これらのコマンドレットでの出力内容についての詳細はありません。そのため、レポートに基づく what-if 分析の代わりとして使用しないでください。

手順 4: ジョブを監視する

トリム ジョブは非同期で実行されます。Learn によると、削除は今後数日間にわたってバッチで行われ、データ量、サービス正常性、ファームの負荷によって所要時間が変わります。サイト単位のジョブは次のコマンドで確認できます。

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

ライブラリのジョブについては、Learn のトリムのページで Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <name> が挙げられています。ジョブを停止するには Remove-SPOSiteFileVersionBatchDeleteJob または Remove-SPOListFileVersionBatchDeleteJob を使用します。キャンセルするとそれ以降の削除は停止しますが、すでに削除されたバージョンは復元されません。

ストレージ レポートがすぐに変わるとは期待しないでください。Microsoft Learnのサイト ストレージ上限のページには、ストレージ使用量に直近24~48時間の変更が含まれないと記載されています。

手順 5: 新しいバージョンの上限を設定する

トリム ジョブが処理するのは、現時点で存在するバージョンだけです。今後のバージョンを制御するには、サイトまたはライブラリにバージョン ポリシーを設定します:

  • サイトの場合: Automatic の上限には Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $true を使用します。適用範囲の選択には、Microsoft Learnに記載されている -ApplyToNewDocumentLibraries と -ApplyToExistingDocumentLibraries を使用します。
  • ライブラリの場合: Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true。

サイトまたはライブラリのポリシーを設定しても、既存のバージョンはトリムされません。そのため、既存のバージョンについてはトリム ジョブをキューに入れてください。既存のライブラリへの変更はバックグラウンド ジョブで処理され、Microsoft Learnによると最大24時間かかる場合があります。Microsoft Learnには、ライブラリのバージョン数の上限を下げると、新しく作成されたバージョンごとに最大20件ずつ、新しい上限を超える既存のバージョンが段階的にトリムされるとも記載されています。管理センターの UI では、メジャー バージョンが100未満の設定や、有効期限が30日未満の設定は受け付けられません。Microsoft Learnでは、公開APIを通じてより低い値を設定することは可能だが、意図しないデータ損失を引き起こす可能性があるため推奨されないと述べています。

手順 6: テナント全体でのトリム

Microsoft Learnには、New-SPOTenantApplyFileVersionPolicyJob などのテナント レベルのコマンドレットが記載されています(-CollectVersionData、-TrimVersions、-SetVersionPolicy を含む)。これらはパブリック プレビューで提供されており、SharePoint Advanced Management ライセンスまたは Copilot ライセンスが必要です。また、読み取り専用、ロック済み、アーカイブ済みのサイトは対象外です。テナント ジョブは同時に1つしか実行できません。多数のサイトを管理している場合は、スレッドにあるような CSV ループの方法と比較検討してください。

不明な点

  • マイナー バージョンのみのファイル: 投稿者は、メジャー バージョンとして一度も発行されず、0.192 のような数百のマイナー バージョンを持つファイルについて質問していました。Microsoft Learnには、バージョン数の上限によるトリムがこれらをどのように扱うかは記載されていません。本番環境に手を加える前に、テスト用のライブラリを作成してそのようなファイルを追加し、小規模なジョブを実行して確認してください。
  • 結果の不一致: 保持されたすべてのメジャー バージョンについて、すべてのマイナー バージョンが残ったという投稿者の観察は、私が確認したページでは説明されていません。
  • 保持: Microsoft Learnのトリムのページでは、保持ポリシーまたは eDiscovery 保留の下にあるバージョンについて FAQ を参照していますが、そのページ自体では動作の説明はありません。

関連情報

データソース

Entities in this article

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

Related articles

RSS