クラシック ページ評価の要件

クラシック ページ コンポーネントは SharePoint Online を評価します。 SharePoint Server やその他のオンプレミス ソースは評価されません。

最新の Microsoft 365 Assessment ツール リリースをダウンロードします。 コア クラシック ページの準備分析は、バージョン 1.15.0 以降で利用できます。 このガイダンスに記載されている Microsoft Graph 監査の使用フロー、 --auditlogwindowdays、 classicpageauditusage.csv コントラクトには、バージョン 1.16.0 以降が必要です。

21Vianet によって運用される GCC High、DoD、または Microsoft 365 のテナントと、カスタム SharePoint URL (バニティ URL) を使用するテナントに対して、appsettings.jsonを構成します。 評価ツールの構成に関するページを参照してください。

認証

このツールでは、次の認証モードがサポートされています。

アプリケーション認証は、フルテナント評価に推奨されます。 委任された評価では、サインインしているアカウントがアクセスできるサイトにのみアクセスできます。

専用のMicrosoft Entra アプリケーションを使用し、選択した認証モードで必要なアクセス許可の種類のみを付与します。 このページのアクセス許可テーブルは、Assessment 1.16.0 のクラシック ページ コンポーネントに対して権限があります。

委任されたアプリケーションを作成する

1. Microsoft Entra 管理センターで、[アプリの登録] を開き、[新しい登録] を選択します。
2. 名前を入力してください。 [ サポートされているアカウントの種類] で、[ シングル テナントのみ - <テナント>] を選択し、アプリケーションを登録します。
3. [API のアクセス許可] で、[アクセス許可の追加] を選択します>Microsoft Graph>[アクセス許可の削除] を選択し、[Sites.Read.AllとUser.Read] を選択して、[アクセス許可の追加] を選択します。
4. [アクセス許可の追加>SharePoint>[委任されたアクセス許可] を選択し、[AllSites.Read] を選択して、[アクセス許可の追加] を選択します。
5. 評価で監査の使用状況が収集される場合は、Microsoft Graph の委任されたアクセス許可を AuditLogsQuery-SharePoint.Read.All追加します。
6. [<テナントに管理者の同意を付与する>] を選択し、[はい] を選択します。
7. --applicationidのアプリケーション (クライアント) ID をコピーします。

[対話型認証] の [ 認証] で、[ プラットフォームの追加>Mobile およびデスクトップ アプリケーション] を選択し、カスタム リダイレクト URI http://localhostを追加して、[構成] を選択 します。

デバイス認証の場合、リダイレクト URI は必要ありません。 [ 認証>Advanced 設定] で、[ パブリック クライアント フローを許可する] を [はい] に設定し、[保存] を選択 します。

対話型認証とデバイス認証の両方に使用されるアプリケーションには、両方の設定が必要です。

アプリケーション認証アプリケーションを登録する

1. シングルテナント アプリの登録を作成します。 アプリケーション認証にはリダイレクト URI は必要ありません。
2. [ API のアクセス許可] で、委任された既定の Microsoft Graph User.Read アクセス許可を削除します。
3. [アクセス許可の追加>Microsoft Graph>アプリケーションのアクセス許可] を選択し、[Sites.Read.All] を選択して、[アクセス許可の追加] を選択します。
4. [アクセス許可の追加>SharePoint>アプリケーションのアクセス許可] を選択し、[Sites.Read.All] を選択して、[アクセス許可の追加] を選択します。
5. 評価で監査の使用状況が収集される場合は、Microsoft Graph アプリケーションのアクセス許可を AuditLogsQuery-SharePoint.Read.All追加します。
6. [ 証明書 & シークレット>Certificates] で、[ 証明書のアップロード] を選択し、パブリック証明書を選択して、[ 追加] を選択します。
7. [<テナントに管理者の同意を付与する>] を選択し、[はい] を選択します。
8. --applicationidのアプリケーション (クライアント) ID をコピーします。
9. 評価を実行するアカウントに、一致する秘密キー証明書をインストールまたは安全に提供します。

その他の証明書生成オプションについては、「 認証の構成」を参照してください。 汎用サンプルからより広範なアクセス許可をコピーしないでください。このページのクラシック ページアクセス許可テーブルを使用します。

アプリケーション証明書

アプリケーション認証には、Microsoft Entra アプリケーションに関連付けられている証明書が必要です。 公開証明書をアプリ登録にアップロードし、評価を実行しているアカウントが一致する秘密キーにアクセスできることを確認します。

アプリケーション認証の例では、現在のユーザーの 個人用 証明書ストアで証明書を使用します。

--certpath "My|CurrentUser|<certificate-thumbprint>"

この値では、 My は個人用証明書ストアを識別し、 CurrentUser は評価を実行しているアカウントを識別し、最終的な値は証明書の拇印です。 認証セットアップ ガイダンスでは、証明書を作成し、アプリ登録に追加し、拇印を見つける方法について説明します。

アクセス許可

現在のクラシック ページの実装には、次のアクセス許可が必要です。

ページ インベントリは、SharePoint LimitedWebPartManager API を介して Web パーツの構成を読み取ります。 評価バージョン 1.16.0 では、この表の読み取りアクセス許可を使用して、ページと Web パーツの抽出を完了できます。

評価を開始する前に、構成されたアクセス許可に対して管理者の同意を付与します。

これらのアクセス許可は読み取り専用です。 PnP PowerShell によるモダン ページの作成または更新は許可されません。 別の変換アプリケーションと PnP PowerShell 変換アクセス許可ガイダンスを使用します。

使用状況の監査アクセス許可

--skipusageinformationを指定しない限り、評価は監査イベントのClassicPageViewed、ClassicPageCreated、およびClassicPageEditedについて Microsoft Graph に対してクエリを実行します。

認証モードで使用されるアクセス許可の種類に AuditLogsQuery-SharePoint.Read.All を追加します。

管理者の同意を付与します。 委任された認証の場合は、サインインしたアカウントも Microsoft Purview で監査データを検索する権限を持っている必要があります。

アクセス許可がない場合でも、ページの検出と Web パーツの分析は完了できます。 監査行は failedマークされ、 SkipReason はアクセス許可が不足していることを説明します。

監査の可用性

• Microsoft Purview 監査が使用可能であり、テナントの記録アクティビティであることを確認します。
• 統合監査インジェストは、ほとんどの組織で既定で有効になっています。 UnifiedAuditLogIngestionEnabledを確認します。Falseされたら、クエリを実行する前に有効にします。 組織のカスタマイズを最初に有効にする必要があり、変更が反映されるまでに最大 60 分かかる場合があります。
• 監査が無効になっているか、Microsoft Purview が Microsoft 365 - 接続されていないと報告する場合は、 監査 ソリューションを開 き、[開始] を選択し、 アプリのセットアップ が完了するまで待ちます。 インジェスト プロパティは、Microsoft 365 がまだ Purview Audit バックエンドに接続されている間に True できます。
• 管理プロパティは、Graph 監査クエリ バックエンドの準備が整う前に True を返すことができます。 バックエンドの状態が AuditingDisabledTenant HTTP 400 は、テナント レベルのプロビジョニングまたは伝達を示すことができます。インジェストと Purview 接続状態の両方を確認してから、アクセス許可エラーとして扱います。
• 新しいイベントが利用可能になるまでに約 60 分から 90 分かかる場合があります。 organizationに対して監査が最初に有効になると、イベントが検索可能になるまでに数時間かかることがあります。
• --auditlogwindowdays は 1 から 180 までの値を受け取ります。 既定値は 14 です。
• ツールで使用される Microsoft Graph 監査クエリ API は、グローバル サービスでのみ使用できます。 現在のツールでは、ソブリン クラウド環境の skipped として監査コレクションが記録されます。

監査データが必要ない場合、または使用できない場合は、 --skipusageinformation を使用します。 その場合、 classicpageauditusage.csv は生成されません。

レポート プラットフォーム

CSV レポートの生成は、Windows、macOS、およびLinuxでサポートされています。 Power BI テンプレートの生成には Windows が必要です。

macOS または Linux で実行された評価用の Power BI テンプレートを作成するには、完全な assessment-ID フォルダーを同じツール バージョンの Windows インストール ディレクトリにコピーし、Windows で report コマンドを実行します。

データの処理

評価出力には、テナントとサイトの URL、アプリケーション識別子、ユーザー情報、監査アクティビティ、Web パーツ タイトル、Web パーツの構成を含めることができます。

• ページ修飾子が不要な場合は、 --skipuserinformation を使用します。
• 構成の詳細が必要な場合にのみ、 --exportwebpartproperties を有効にします。
• 評価チームの外部で共有する前に、CSV ファイルを確認してサニタイズします。
• 証明書、トークン、パスワード、または未保存の認証資料を共有レポート出力に含めてはいけません。

次の手順

1. クラシック ページ評価を実行します。
2. クラシック ページの結果を解釈して優先順位を付けます。
3. 必要に応じて、発行ページの準備状況を確認します。
4. 選択したページを PnP PowerShell で変換します。
5. 変換されたページを検証します。

リファレンス

• クラシック ページ評価 CSV リファレンス
• 一般的な評価 CSV リファレンス