--mode Classic --classicinclude Pagesを使用してクラシック ページ評価を実行します。
開始する前に、 クラシック ページの要件を完了します。
ページモダン化ワークフロー
- クラシック ページ評価を構成して実行します。
- サイト、Web、監査のカバレッジを検証します。
- ページの結果を解釈して優先順位を付けます。
- ブロックしている Web パーツを修復またはマップします。
- 選択したページを PnP PowerShell で変換します。
- モダン ページを検証し、移行ウェーブを展開します。
完全なテナントを評価する
アプリケーション認証は、フル テナント評価に推奨されます。
コマンドを実行する前に、 アプリケーション証明書を構成します。
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.jsonでAdminCenterUrlとMySiteHostUrlの両方を構成し、--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=failedとQueryTimeoutで始まるSkipReasonをclassicpageauditusage.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 を使用します。
次の手順
- クラシック ページの結果を解釈して優先順位を付けます。
- 必要に応じて、発行ページの準備状況を確認します。
- 選択したページを PnP PowerShell で変換します。
- 変換されたページを検証します。