クラシック ページ評価を実行する

--mode Classic --classicinclude Pagesを使用してクラシック ページ評価を実行します。

開始する前に、 クラシック ページの要件を完了します。

ページモダン化ワークフロー

  1. クラシック ページ評価を構成して実行します。
  2. サイト、Web、監査のカバレッジを検証します。
  3. ページの結果を解釈して優先順位を付けます。
  4. ブロックしている Web パーツを修復またはマップします。
  5. 選択したページを PnP PowerShell で変換します。
  6. モダン ページを検証し、移行ウェーブを展開します。

完全なテナントを評価する

アプリケーション認証は、フル テナント評価に推奨されます。

コマンドを実行する前に、 アプリケーション証明書を構成します。

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --authmode application `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --certpath "My|CurrentUser|<certificate-thumbprint>"

--tenant値は、https://のない SharePoint ホスト名です。

選択したサイト コレクションを評価する

短いコンマ区切りリストには、 --siteslist を使用します。

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --skipusageinformation `
  --authmode interactive `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --siteslist "https://<tenant>.sharepoint.com/sites/site1,https://<tenant>.sharepoint.com/sites/site2"

より大きなスコープには --sitesfile を使用します。

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --authmode application `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --certpath "My|CurrentUser|<certificate-thumbprint>" `
  --sitesfile "C:\assessment\sites.txt"

サイト ファイルには、1 行に 1 つの絶対サイト コレクション URL が含まれています。 --siteslist--sitesfileを組み合わせないでください。

ページ固有のオプション

オプション 効果
--exportwebpartproperties シリアル化された Web パーツプロパティを classicpagewebparts.csvに追加します。
--skipusageinformation Microsoft Graph 監査使用状況コレクションをスキップし、 classicpageauditusage.csvを生成しません。
--auditlogwindowdays <1-180> 監査ウィンドウを設定します。 既定値は 14 日です。
--skipuserinformation ページ修飾子の情報を省略します。
--homepageonly ページ インベントリを各 Web のホーム ページにフィルター処理します。 サイトスコープの監査結果はフィルター処理されません。
--threads <number> 並列処理を変更します。 調整が懸念される場合は、4 ~ 8 スレッドから開始します。

重要

21Vianet が運営する GCC High、DoD、Microsoft 365 など、ソブリン クラウド環境では、この評価では Microsoft Graph 監査クエリを使用できません。 --skipusageinformationを使用し、監査アクティビティではなく、ModifiedAt、ページの重要度、ビジネス所有者の入力を含むページに優先順位を付けます。

たとえば、ホーム ページのみを評価し、Web パーツのプロパティをエクスポートし、監査の使用をスキップします。

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --homepageonly `
  --exportwebpartproperties `
  --skipusageinformation `
  --authmode application `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --certpath "My|CurrentUser|<certificate-thumbprint>"

スコープに関する考慮事項

  • カスタム SharePoint URL (バニティ URL) を使用するテナントの場合は、appsettings.jsonAdminCenterUrlMySiteHostUrlの両方を構成し、--siteslistまたは--sitesfileを指定します。 評価ツールの構成に関するページを参照してください。
  • 複数地域テナントの場合は、geo ごとに個別の評価を実行します。 --tenantのプライマリ テナント ホストを使用し、geo のサイト コレクションに--siteslistまたは--sitesfileを提供します。
  • 最初に小さな代表的なスコープを実行して、認証、出力、監査アクセス、スキャン期間を検証します。
  • このツールは最大 3 つの並列評価をサポートしますが、並列スキャンを実行すると調整のリスクが高まります。

評価の監視と制御

使用可能な評価を一覧表示する:

microsoft365-assessment.exe list

継続的に更新された状態を表示します。

microsoft365-assessment.exe status

評価を一時停止して再起動します。

microsoft365-assessment.exe pause --id <assessment-id>
microsoft365-assessment.exe restart --id <assessment-id>

評価 ID は、ローカル データ フォルダーの名前でもあります。 進行状況の変更が停止した場合は、そのフォルダー内のログを確認します。

サイトの処理が完了すると、 status は、スキャン後の作業の実行中に Finalizing を表示できます。 評価は、各ページ監査クエリに対して最大 90 分待機します。 クエリは、その待機中に notStarted または running したままにすることができます。 待機の有効期限が切れる前に監査チャンクが成功しない場合は、レコードQueryStatus=failedQueryTimeoutで始まるSkipReasonclassicpageauditusage.csvします。 評価ログ [AuditLog] エントリを確認してから、 Finalizing をハングとして扱います。

レポート出力の生成

CSV ファイルを生成し、Windows では Power BI テンプレートを生成します。

microsoft365-assessment.exe report --id <assessment-id>

レポートを生成するには、評価を Finished するか、意図的に Paused する必要があります。 このツールは、まだ実行中または最終決定中の評価に対するレポート要求を拒否します。

カスタムの場所に CSV ファイルのみを生成します。

microsoft365-assessment.exe report --id <assessment-id> --mode CsvOnly --path "C:\reports"

既定では、出力は assessment-ID フォルダーの report サブフォルダーに書き込まれます。

セミコロン区切りのエクスポートが必要な場合は、 --delimiter Semicolon を使用します。 生成されたレポートが自動的に開かないようにするには、 --open false を使用します。

次の手順

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

リファレンス