この主要なワークフローは、SharePoint Online の既定の SitePages ライブラリ内の従来の Wiki ページと Web パーツ ページを変換します。 Microsoft 365 評価ツールを使用してページとその Web パーツを識別し、PnP PowerShell を使用して承認済みページを変換し、より大きなウェーブを処理する前に各結果を検証します。
ページ、ブログ ページ、 SitePages外のページ、ホーム ページ、および SharePoint Server ソースを発行するには、個別の高度な手順が必要であり、ページウェーブ スクリプトでは受け入れられません。
このワークフローでは、プライマリ実行パスとして PnP PowerShell を使用します。 ページ変換エンジンはオープンソースの PnP Framework の一部であり、Microsoft サポート SLA を持っていません。
ページ変換ワークフロー
- 完了した評価カバレッジから代表的なページ ウェーブを選択します。
- ブロックしている Web パーツを解決し、インプレース ターゲットまたはクロスサイト ターゲットを選択します。
- テナント所有の PnP PowerShell アプリケーションと必要なアクセス許可を準備します。
- ソースを保持する既定値とログを使用して、代表的なウェーブを変換します。
- ウェーブを展開する前に、生成されたすべてのページを検証します。
1. ページ候補を選択する
完了した クラシック ページ評価から始めます。 ページを選択する前にスキャン カバレッジを確認します。
最初のウェーブの場合:
- 成功したサイトと Web スキャンの
WikiPageまたはWebPartPage行を選択します。 - マップされていない Web パーツがなく、マッピング率が高いページを優先します。
- 正確な Web パーツの種類とマッピングについては、
classicpagewebparts.csvを確認してください。 -
WebPartCount=0を使用して任意のページを手動で検査します。 ゼロパート ページのマッピング率が 100 の場合は、Assessment が Web パーツを抽出しなかったことを意味します。 - 変換と検証プロセスが証明されるまで、ホーム ページは避けてください。
- 変換後に存在する必要がある、表示されるテキスト、Web パーツ、リンク、画像、レイアウトを記録します。
MappingPercentage=100 は計画シグナルです。 変換が正常に実行されたり、予想されるコンテンツが保持されたりすることは保証されません。
代表的なウェーブを構築する
これらのディメンションが一致する場合にのみ、ページを同じ変換パターンとして扱います。
| Dimension | 別のパターンを定義する理由 |
|---|---|
PageType |
Wiki と Web パーツの変換動作を分離します。 |
Layout |
生成されたセクションと列を制御します。 |
| 順序付き Web パーツ署名 | Web パーツの種類、順序、非表示状態、または閉じた状態が異なるページは、異なる方法で変換できます。 |
| マッピング結果 | マップされていない Web パーツまたは異なるマップされた Web パーツには、個別の修復と検証が必要です。 |
| ターゲット アプローチ | インプレース変換とクロスサイト変換では、依存関係と URL の動作が異なります。 |
| 特殊な処理 | ホーム ページ、カスタム発行レイアウト、および 0 部構成のページには、個別のレビューが必要です。 |
classicpagewebparts.csvを使用して、各ページの順序付けされた Web パーツ署名を作成します。
MappingPercentageまたはUnmappedWebPartsによってのみグループ化しないでください。完全にマップされたページには、さまざまな Web パーツの種類とランタイム動作を含めることができます。
最初のウェーブの場合:
- 失敗したカバレッジ、サポートされていないページの種類、ホーム ページ、0 部構成のページ、未解決のマッピングを除外します。
- ページの種類、レイアウト、順序付けされた Web パーツの署名で残りのページをグループ化します。
- 移行する予定の各パターンから少なくとも 1 つのページを選択します。
- 同じパターンのページで大きく異なる Web パーツのプロパティまたはコンテンツの依存関係を使用する場合は、別の担当者を追加します。
- 明確なコンテンツ ベースラインを持つページと、結果を検証できるビジネス所有者を希望します。
アクティビティと変更の日付を使用して、パターン カバレッジの代わりにではなく、最初に処理するパターンに優先順位を付けます。
「PowerShell を使用して代表的なページ グループを構築する」を参照してください。
フィールドからコマンドへのマッピングと選択したページの例については、「従来の ページ評価レポートを解釈する」を参照してください。
2. ブロックを解決し、ターゲットを選択する
ページの種類、レイアウト、マップされていない Web パーツの組み合わせで候補ページをグループ化します。 ウェーブを変換する前に、一般的なブロックを解決します。
- Wiki ページと Web パーツ ページの場合、ソース サイトに依存関係が残るため、インプレース変換が推奨される出発点です。
- クロスサイト Wiki と Web パーツの変換には、リンク、ファイル、リスト、ユーザー、分類に対する追加の検証が必要です。
「 インプレース変換またはクロスサイト変換を選択する 」および「 クラシック Web パーツ マッピングを確認する」を参照してください。
3. PnP PowerShell を準備する
PnP PowerShell には、テナント所有のMicrosoft Entra アプリケーションが必要です。 読み取り専用評価アプリケーションとは別の変換アプリケーションを使用します。
プライマリ 対話型フローの場合は、委任された SharePoint AllSites.Manageを、サインインしているユーザーの既存のサイトのアクセス許可と共に使用します。 アイテム レベルの一意のアクセス許可をコピーするには、 AllSites.FullControlが必要です。それ以外の場合は、そのコピーを明示的にスキップします。
PnP PowerShell で選択したページの変換に従って、アプリケーションを登録し、接続し、最初の変換を実行します。
4. 代表的なウェーブを変換する
処理するページの種類、レイアウト、および Web パーツの組み合わせを表す小さなウェーブを変換します。
最初のウェーブの場合:
- 生成されたページで既定の
Migrated_プレフィックスを使用できるようにします。 -
-TakeSourcePageName、-Overwrite、またはホーム ページの置換オプションは使用しないでください。 - ファイル ログを有効にし、wave マニフェストを使用してログを保持します。
- 最初の予期しないエラーまたはコンテンツの不一致で停止します。
生成されたページが承認され、ロールバック 計画が存在した後にのみ、ソース名変更または上書き動作を有効にします。
Page wave スクリプトリファレンスの埋め込みスクリプトを使用して、承認されたすべての代表ページを同じ安全性と結果コントラクトで処理します。
5. 検証と展開
エラーなしでを開くだけでは、十分な検証ではありません。 生成されたページは存在する可能性があり、空白または不完全です。
ソースと生成されたページ、変換ログ、コンテンツ、Web パーツ、レイアウト、リンク、イメージ、メタデータ、アクセス許可、およびパブリケーションの状態を検証します。 選択したすべてのページが受け入れ条件を満たしている場合にのみ、ウェーブを展開します。
「変換されたクラシック ページを検証する」を参照してください。
すべての代表的な結果が Passedマークされたら、 Convert-SelectedPages.ps1 を使用して、ユーザーが承認したすべての行を処理します。 このスクリプトは、変換パターンに渡された担当者がいないページを拒否します。