大量の SharePoint アクセス許可を、1 件ずつではなくレポートから一括修正する
Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.
By Mirko Peters · · Updated
SharePoint のアクセス許可を一括で修正します。レポートをエクスポートし、各行に「保持」「削除」「リセット」のいずれかを付けます。PnP PowerShell のスクリプトはまず 1 つのサイトでテストし、その後に結果を確認します。
Automatically translated with AI from the original post. Read the English original
SharePoint のアクセス許可を一括で修正するには、まず誰がアクセスできるかをレポートとしてエクスポートし、各行に「保持」「削除」「リセット」のいずれかを付けます。その後、判断内容を読み込むスクリプトを実行します。このガイドは、一意のアクセス許可を持つ項目が何百もあり、1 件ずつクリックして修正したくない SharePoint 管理者を対象としています。判断用の一覧の作り方、作業を行う PnP PowerShell のコマンドレット、Microsoft のレポートに含まれない内容、そしてテスト、記録、実行結果の確認の方法を説明します。架空の数値を使った具体例で、一連の流れを示します。
重要なポイント
- SharePoint のアクセス許可を一括で修正するには、まずレポートから始めます。スクリプトによるすべての変更は、「保持」「削除」「リセット」のいずれかが付けられた 1 つの行にさかのぼれる必要があります。
- Microsoft のサイト共有レポートには、一意のファイル、ユーザー、アクセス許可、リンクがすべて表示されます。しかし、「Anyone」リンクや SharePoint グループ内の個々のユーザーは含まれません。
- 一括修正の大部分は、3 つの PnP PowerShell コマンドレットで対応できます。Remove-PnPGroupMember、Set-PnPListItemPermission、Remove-PnPSiteCollectionAdmin です。
- 項目をリストから継承するアクセス許可にリセットすると、その項目の一意のアクセス許可が削除されます。アクセス許可の肥大化に対する解決策として、多くの場合もっとも簡潔な方法です。
- スクリプトは 1 つのサイトでテストし、すべての変更の記録を残します。その後にもう一度レポートを実行し、問題が解消されたことを確認してください。
1 件ずつ修正する方法がうまくいかない理由
多くのSharePoint permissionsの問題は、少しずつ蓄積していきます。ある人がファイルを1つ同僚と共有します。別の人は、とっくに終わったプロジェクトのために、フォルダーのアクセス許可の継承を解除します。数年たつと、一部のドキュメント ライブラリには固有のアクセス許可を持つアイテムが数百件も存在するようになり、そのうちどれがまだ必要なのか、誰にも分からなくなっています。
1 件ずつ修正する方法には 3 つの問題があります。時間がかかること、項目を見落としやすいこと、そして何を変更したかの記録が残らないことです。そのため、ミスを元に戻すことも、監査人への説明もできません。
一括修正では順序を逆にします。まず事実をレポートに集めます。次に担当者が判断します。そのうえで初めてスクリプトが実行され、判断が付けられた行だけを処理します。こうすることで、自動化による速さと、手作業によるレビューの慎重さを両立できます。
SharePoint のアクセス許可を一括で修正する方法: 5 つの手順
以下の手順を順番に実行してください。
- 事実をエクスポートする。サイトのレポートを作成します。Microsoft のファイルとフォルダーの共有レポートに関するガイドによると、サイト管理者は設定、サイトの使用状況から、外部ユーザーと共有セクションのレポートの実行を使って実行します。CSV の保存先を選択でき、完了するとメールが届きます。
- 判断用の列を追加する。CSV を Excel で開き、「保持」「削除」「リセット」の 3 つの値を入力できる列を追加します。理由を記入する列も別に追加します。自分で判断できない行は、サイト所有者に確認してもらってください。
- 判断内容を中心にスクリプトを書く。
Import-Csvでファイルを読み込み、行を順に処理して、判断の種類ごとに 1 つのコマンドレットを実行します。判断が付いていない行はすべてスキップします。 - まずテストサイトかライブラリ1つで試してください。 スクリプトは、最初にテストサイトまたは単一のライブラリで実行してください。結果が想定どおりかどうかを比べてください。
- 2つ目のレポートで確認します。 本番で実行したあとに、レポートをもう一度作成してください。削除した行は消えているはずで、残した行は変わっていないはずです。
手順2を省略しないでください。スクリプトの安全性は、読み取る一覧の正確さに依存します。
何かをリセットする前に、アクセス許可の継承の仕組みを確認する
Microsoft サポートのページSharePoint のリストまたはライブラリのアクセス許可をカスタマイズするでは、フォルダー、リスト、ドキュメントは通常、それらを含むサイトからアクセス許可を継承すると説明されています。リストまたはライブラリに独自のアクセス許可を設定するには、所有者が「アクセス許可の継承を停止」を選択します。その下の項目は新しい設定を継承するようになります。元に戻すには、[アクセス許可] タブの「固有のアクセス許可を削除」を使います。これにより、設定したカスタムのアクセス許可が削除されます。
同じページには、大量の作業に関係する3つの注意点があります。
- 10万項目の上限。 項目数が10万を超えるリスト、ライブラリ、フォルダーでは、継承を中断したり復元したりすることはできません。大きなライブラリ内の1つのファイルについては、継承を中断できる場合があります。
- ユーザーを削除すると子項目にも影響します。 ユーザーまたはグループを削除すると、継承が中断された項目を含む子項目からも削除されます。削除を実行する前にログを確認してください。この操作は元に戻せません。
- 制限付きアクセスは残ります。 1つの項目だけが共有された相手には、サイトへの制限付きアクセスが付与されます。項目の共有を解除しても、このアクセスは取り消されません。
Microsoft は SharePoint グループの利用を推奨しており、項目レベルのアクセス許可も適切な範囲での利用であればサポートされていると説明しています。当社の基本方針は、個々のユーザーではなくグループを通じてアクセスを割り当てることです。こうすることでサイトのアクセス許可を把握しやすくなり、修正が必要な固有のアクセス許可も減らせます。
どの問題にどのコマンドレットを使うか
PnP PowerShell には、大量の修正の大半に対応するコマンドレットがあります。よく使われる3つを紹介します。
SharePoint グループからユーザーを削除する。 Remove-PnPGroupMember のリファレンスに構文が記載されています。例: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'。退職者がメンバー グループに残っている場合など、グループのメンバーシップに関する問題に使用します。
項目のアクセス許可を変更またはリセットする。 Set-PnPListItemPermission のリファレンスには、次のオプションが記載されています。
-AddRoleと-RemoveRoleは、1つの項目に対してユーザーまたはグループのアクセス レベルを追加または削除します。利用可能なロールはGet-PnPRoleDefinitionで確認できます。-ClearExistingは、新しいロールを追加する前に、その項目に既存のアクセス許可をすべて削除します。-InheritPermissionsは、項目をリストから継承するように戻し、固有のアクセス許可を削除します。-SystemUpdateは、新しいバージョンを作成したり Power Automate をトリガーしたりせずにアクセス許可を変更します。
多くの場合、リセットが最も簡潔な解決策です。誰かが一度共有したことで項目に固有のアクセス許可だけが付いている場合、リセットするとライブラリのルールに戻ります。
サイト コレクションの管理者を削除する。 Remove-PnPSiteCollectionAdmin のリファレンスには、Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com" と記載されています。指定しなかった管理者のアクセスはそのまま残ります。ユーザーの一覧を渡すこともできます。
あるユーザーを別のユーザーに置き換える場合は、2つの手順を実行します。まず、古いユーザーがアクセスできていた場所に新しいユーザーを追加し、その後で古いユーザーを削除します。追加を先に行うことで、途中でアクセスを失う人が出ないようにします。
レポートに表示されない内容
レポートは出発点であり、すべてを示すものではありません。Microsoft の共有レポートのページには、CSV に含まれない内容が次のように記載されています。
- SharePoint グループ内の個々のユーザー。グループは表示されますが、そのメンバーは表示されません。
- メールで送信されたもののクリックされていないリンク。
- 匿名ユーザー向けリンク(誰でも利用可能なリンク)。
これは実際に影響があります。ある人物のアクセス範囲を調べたい場合、レポートにはグループが表示されるため、グループのメンバーを別途確認する必要があります。公開共有を削除したい場合、レポートには Anyone リンクが一切表示されないため、SharePoint 管理センターの データ アクセス ガバナンス レポートなど、別のソースが必要です。Microsoft によると、これらのレポートには SharePoint Advanced Management が必要です。
SharePoint Online の単一サイトについては、項目を変更する前に、サイトの設定 でサイトのアクセス許可と使用中のアクセス許可レベルも確認してください。そのうえで、特定のサイトだけでなくテナント全体について SharePoint のレポート機能を確認します。サイトごとの CSV では、数百のサイトには対応できません。
Microsoft 365 グループに接続されたサイトでは、グループのメンバーシップはサイト独自のグループではなく、グループを通じて管理されます。サイト グループを編集するスクリプトでは、Microsoft 365 グループに属しているユーザーのアクセスは修正できません。
スクリプトを安全に実行する
一括処理のスクリプトは、短時間で大きな被害を与える可能性があります。最初の本番実行の前に、次の保護機能を組み込んでください。
- ドライラン スイッチを追加します。 独自のスクリプトに
-DryRunパラメーターを持たせると、計画した各操作を表示するだけで、何も変更しないようにできます。その出力はサイト所有者と一緒に確認してください。 - 変更する前にログを記録します。 各行について、まず変更前の状態をログに書き込みます。項目のパス、ユーザー、そしてフル コントロール、編集、読み取りなどのアクセス許可レベルです。このログが元に戻すための手段になります。
- バッチ単位で作業します。 50 件を実行して確認し、その後に次の 500 件を実行します。最初の小さなバッチで、誤った前提を早い段階で発見できます。
- 元のレポートを保管します。 判断内容を記録した CSV とログは、サイト所有者だけが開けるフォルダーに保存してください。Microsoft も、レポート自体について同じ管理を推奨しています。レポートには、誰が何にアクセスできるかが記載されているためです。
- グループ メンバーシップの変更は別の実行で行います。 項目のアクセス許可の修正とグループ メンバーシップの修正を分けて実行すると、変更の種類ごとに個別に確認できます。
例: 1 つのドキュメント ライブラリのクリーンアップ
以下の数値は仮のものです。
あるプロジェクト サイトには、ドキュメント ライブラリが 1 つあります。レポートは 620 行です。並べ替えた後、管理者とサイト所有者が各行に次のように印を付けます。
- 410 行: 保持。通常のグループ ベースのアクセス許可です。
- 150 行: リセット。古い共有から残っている、個別のアクセス許可が設定された単一ファイルです。
- 40 行: 削除。元委託先の担当者に直接アクセス権を与えています。
- 20 行: 不明。質問を添えて所有者に差し戻します。
管理者は、2 つの分岐を持つスクリプトを書きます。リセットの分岐では、各ファイルに対して -InheritPermissions を指定して Set-PnPListItemPermission を実行します。削除の分岐では、元委託先の担当者が所属する各グループから、その担当者を Remove-PnPGroupMember で削除します。スクリプトは操作ごとに 1 行のログを書き込みます。日付、項目、変更前の状態、変更後の状態です。
まず管理者は、ライブラリのコピーの 20 行に対してスクリプトを実行します。結果は計画どおりでした。本番の実行は 1 晩で完了しました。2 回目のレポートには 410 行と 20 行が表示され、管理者が想定したとおりでした。ログはレポートと同じ場所に保存されているため、誰でも何が行われたかを確認できます。
よくある間違い
- 判断リストなしでスクリプトを実行する。 後から、なぜ項目が変更されたのかを説明できなくなります。
- 意図的に固有のアクセス許可を設定しているライブラリで、継承をリセットする。 一部のフォルダーは、意図的に制限されています。それらは「保持」としてマークしてください。
- レポートが完全だと信用する。 レポートには Anyone リンクや SharePoint グループのメンバーが含まれていません。
- 追加する前に削除する。 あるユーザーを別のユーザーに置き換える場合は、先に追加してください。
- ユーザーごとに個別にアクセスを付与する。 項目ごとに 1 人のユーザーへ付与するのではなく、グループを通じてアクセス許可を付与してください。そうすれば、次回のレビューが短くなります。
- Microsoft 365 グループを忘れる。 サイトを整理した後も、グループのメンバーシップを通じてアクセスを維持している人がいる場合があります。
- ログも 2 つ目のレポートもない。 これらがなければ、修正を証明することも、元に戻すこともできません。
ソフトウェアが役立つ場面
手元にあるツールから始めてください。サイトの共有レポートと管理センターのレポートが事実を示します。変更は PnP PowerShell で行い、判断内容とログはスプレッドシートで管理します。
サードパーティ製ツールの中には、レポートと修正を1つの画面にまとめたものがあります。その一例が Cognillo の SharePoint Essentials Toolkit です。ベンダーの製品ページによると、サイト、フォルダー、アイテムごとのアクセス許可レポートを作成でき、1人のユーザーが何にアクセスできるかを一覧表示し、あるユーザーを別のユーザーに置き換えることができます。また、レポートから権限や共有リンクを修正することもできます。さらに、レポートとタスクのスケジュール実行やエクスポートにも対応しているとされています。これらはベンダーの説明であり、M365.FM では検証していません。上記の手作業による方法は、これらのツールがなくても機能します。
開示: Cognillo は M365.FM のスポンサーです。
次のステップ
既知のアクセス許可の問題があるサイトを1つ選び、共有レポートを実行して、CSV に判断用の列を追加してください。次に、そのリストを使って、まずテスト用のライブラリで SharePoint のアクセス許可を一括で修正し、ログを保存してください。