SharePoint Server 2016 でのサイト コレクションのアップグレードの問題のトラブルシューティング
適用対象:
2016 2019 Subscription Edition SharePoint in Microsoft 365
サイト コレクションを SharePoint Server 2019 にアップグレードすると、エラーが発生することがあります。 この記事では、そのようなエラーとその対処方法について説明します。
アップグレードの状態とログ ファイルを確認する
アップグレードの状態表示とログ ファイルを見ると、アップグレード プロセスの間に発生した問題がわかります。 アップグレード ログ ファイルのすべてのエラーを注意深く検討することをお勧めします。 警告は問題を示していない場合もありますが、すべてを検討し、問題の原因になる可能性があるかどうかを判別する必要があります。
サイト コレクションのアップグレード状態ページを確認します。
サイト コレクションの [ サイトの設定] ページで、[ サイト コレクションの管理] セクションの [ サイト コレクションのアップグレード] をクリックします。 [ サイト コレクションのアップグレード] ページで、[ サイト コレクションのアップグレード状態の確認] をクリックします。
ページが表示されない場合は、[ サイトの設定] ページを確認します。 [ サイトの設定] ページが動作していてアップグレードが成功している場合、マスター ページまたはホーム ページに問題がある可能性があります。 [ サイトの設定] ページが動作していない場合、サイト コレクションのアップグレード ログ ファイルで問題の情報を確認してください。
サイト コレクションのアップグレード ログ ファイルを確認します。 サイト コレクションのアップグレード ログは次の場所から確認できます。
サイト コレクション管理者の場合: サイト コレクション自体に格納されているサイト コレクションアップグレードのログ ファイルもあります(
http://<SiteName>/_catalogs/MaintenanceLogs/YYYYMMDD-HHMMSS-SSS.txt)、 YYYYMMDD は日付、 HHMMSS-SSS は時間 (24 時間のクロック形式、分、秒、ミリ秒)。ファーム管理者の場合: サイト コレクションのアップグレード ログ ファイルとアップグレード エラー ログ ファイルは、%COMMONPROGRAMFILES%\Microsoft Shared\Web サーバー拡張機能\16\LOGS にあります。 ログには、SiteUpgrade- YYYMMDD-HHMMSS-SSS.log という形式で名前が付けられます。 ここで、YYYYMMDD は日付、 HHMMSS-SSS は 時刻 (24 時間のクロック形式、分、秒、ミリ秒)。 これらのファイル システム ログには、問題についての詳細な情報が含まれます。
一般的な問題
以下の問題がアップグレードのエラーや警告またはサイトでの問題の原因になっているかどうかを調べてください。
Q: ページに以前は表示された UI コントロールが表示されない
- A: ページを既定のバージョンにリセット (つまり、再非実体化) します。
サイトの UI を変更すると、サイトのアップグレードで問題が発生する可能性があります。 ページをカスタマイズして UI コントロールを標準とは異なる場所に配置した場合、ページを既定のバージョンにリセットするとコントロールを復旧できます。
ページをリセットするには、[サイトの設定] ページの [ サイトの操作] の [ サイト定義にリセット] リンクを使用するか、SharePoint Designer の [ テンプレートにリセット] コマンドを使用します。
Q: 大きいリストのビューが動作しない
- A: 大きいリストのインデックス列、フォルダー、または新しいビューを作成します。 既存のビューにインデックス列を追加する必要がある場合があります。
リストが非常に大きく、ユーザーがビューを使用したり、制限または調整しきい値を超えるビューを使用したりすると、ビューまたはクエリは許可されません。 フィルター処理されたビューを使用してインデックス列を作成する、項目をフォルダーに整理する、大きいビューのページに項目の制限を設定する、または外部リストを使用することができます。 大規模なリスト調整の詳細と、大規模なリストに関する問題に対処する方法については、「 多数の項目を含むリストとライブラリを管理する」を参照してください。
Q: 重複するコンテンツ タイプ名に関するエラーが表示される
- A: 既定の名前と競合するコンテンツ タイプまたはフィールドの名前を変更します。
場合によっては、カスタム要素 (コンテンツ タイプなど) の名前が、新しいバージョンでの名前と競合することがあります。
アップグレード ログ ファイルに、次のようなエラーが記録される場合があります。
注:
コンテンツ タイプの名前を変更したりコンテンツ タイプを削除したりすると、そのコンテンツ タイプに依存するカスタマイズが動作しなくなる可能性があります。
Q: 個人用サイトが見づらく、正しく表示されない、またはスクリプト エラーが発生する
A: ページを編集する、ページを既定バージョンにリセットする、またはカスタム ファイルを削除または置換します。
カスタムまたはインライン JavaScript または CSS ファイルの問題が原因です。
Q: 個人用サイトのカスタム コンテンツが表示されない、または動作しない
A: マスター ページを変更するか、または特定のゾーンが必要ないようにコンテンツを変更します。
マスター ページに異なるゾーン レイアウトがあり、コンテンツが正しく参照できなくなっている可能性があります。 最終的な手段として、ページを既定のバージョンにリセットすることもできます。 ただし、ページをリセットすると、ゾーン固有のコンテンツが失われる場合があります。
Q: コントロールまたはページを表示できないというエラーが表示される
A: 次のいずれかを行います。
追加した Web パーツがインストールされていない場合は、ファーム管理者にインストールを依頼します。 Web パーツが使用できなくなっている、またはサポートされなくなっている場合は、Web パーツ メンテナンス ビューを使用してページから Web パーツを削除します (単に Web パーツを閉じるのではなく、削除します)。
ページを直接編集した場合は、再度編集してコントロールまたは Web パーツを削除するか、またはページを既定バージョンにリセットします。
インストールされていない、またはサポートされなくなっている Web パーツまたは他のコントロールが、ページに追加されている場合があります。 Web パーツがゾーンに追加されているか、またはページを直接編集してコントロールまたは Web パーツの参照がインラインに直接追加されています (おそらくマスター ページで)。
SharePoint の機能を有効にしなければならない可能性があります。 詳細については、「 サイト コレクション機能を有効または無効にする 」および「 Web パーツのメンテナンス ページを開いて使用する」を参照してください。
Q: アップグレードしたサイトがまったく表示されず、「予期しないエラー」と関連付け IDが表示される
A: カスタム ブランド化で、カスタム コンテンツ プレースホルダーが含まれるカスタム マスター ページを使用している可能性があります。
カスタム マスター ページにカスタム コンテンツ プレースホルダーが含まれ、カスタム ページ レイアウトにもこのカスタム コンテンツ プレースホルダーが含まれる場合は、アップグレード後にエラーでサイトのホーム ページがまったく表示されなくなることがあります。 また、アップグレード後に「予期しないエラーが発生しました」というエラー メッセージが表示されることがあります。