Power Pages トラブルシューティング ガイド

はじめに

こんにちは、Power Platformサポートチームの吉永です。
本記事では Power Pages の一般的なトラブルシューティングと、弊社サポートにお問い合わせいただく場合にご提供いただきたい情報についてご紹介させて頂きます。

このため、ご利用いただいている Power Pages サイトや、Power Pages サイトの作成において問題が発生した場合にはこちらで紹介させて頂いている手順についてご参考にしていただき、問題が解消しない場合については、弊社サポートへのお問い合わせをご検討いただけますと幸いです。

なお、本記事では以下の 2 つの項目に分けてご紹介を行わせて頂きます。

• 第 1 部: お客様ご自身で実施できる一般的なトラブルシューティング手順
• 第 2 部: それでも解決しない場合にサポートへお問い合わせいただく際に、ご用意いただきたい情報

---

第 1 部: 一般的なトラブルシューティング

1. まず試すこと — 診断ツールの活用

問題に遭遇したら、まず以下の診断ツールを活用してください。多くの場合、原因の特定と解決策の提示まで自動的に行われます。

1.1 サイト チェッカー を実行する

サイト チェッカー は、サイトの構成上の問題を自動検出するセルフサービス診断ツールです。結果は エラー・警告・合格 の 3 段階で表示され、修正手順も提示されます。

実行方法:

1. Power Platform 管理センター を開く
2. 管理 > Power Pages > 対象の Power Pages サイト を選択
3. サイトの正常性 パネルで スキャンの実行 をクリック

参照: サイト チェッカーの実行

1.2 Power Pages DevTools 拡張機能でエラーを確認する

Edge ブラウザ向けの開発者ツール拡張機能で、サーバーサイドのエラーメッセージや Liquid のカスタムログを確認できます。

セットアップ手順:

1. Microsoft Power Pages extension for Edge をインストール
2. Portal Management App で Site Setting UserTrace/Debug を true に設定（Private サイトはデフォルトで有効）
3. 問題を再現し、Edge の DevTools (F12) の Power Pages タブでエラーメッセージを確認

参照: Power Pages DevTools 拡張機能

1.3 キャッシュをクリアする

設定変更が反映されない場合は、サーバーサイドキャッシュが原因の可能性があります。
この場合、以下のいずれかの方法を実施することで、キャッシュのクリアが行われます。

• 方法 1: Design Studio のプレビューボタンをクリック
• 方法 2: サイト URL に /_services/about を付加してアクセスし、Clear Cache をクリック（管理者権限で Web サイトにサインインが必要）
• 方法 3: Power Platform 管理センターからサイトを再起動

注意: キャッシュの反映 SLA は最大 15 分です。設定変更後、すぐに反映されない場合は 15 分待ってから確認してください。Clear Cache は全キャッシュをクリアするため、高負荷サイトでは非ピーク時に実行してください。

参照: Power Pages でのサーバー側キャッシュの動作

1.4 既知の問題 (Known Issues) を確認する

お客様が遭遇している問題が既知の問題である可能性があります。以下のページで最新の情報をご確認ください。

参照: Power Pages 既知の問題

---

2. よくある問題と解決方法

発生している症状ごとに、考えられる原因と対処が記載された公式ドキュメントをまとめました。

サイトにアクセスできない / サーバーエラーが表示される

まず、Power Platform 管理センターからサイトの再起動をお試しください。キャッシュの不整合や一時的な接続の問題であれば、再起動だけで解消する場合があります。また、/_services/about ページから Clear Cache を実行することも有効です。

再起動やキャッシュクリアで改善しない場合は、以下のドキュメントを順に確認してください。

• Dataverse 環境 URL が変更されている
• Dataverse 環境が管理モードになっている
• 環境復元により認証接続が切断されている
• Dataverse へのリクエストがタイムアウトしている
• Website Binding が見つからない
• 認証キーの有効期限が切れている

サイトの作成・プロビジョニングに失敗する

サイトの新規作成やプロビジョニング中に問題が発生する場合は、以下を確認してください。

• サイト作成時の権限エラー (Azure Entra アプリ登録権限がない) — Power Pages Core パッケージを最新に更新することで解消する場合があります
• プロビジョニングの問題 - Profile フォームが存在しない — 「Getting set up」画面のまま進まない場合はこちらを確認
• サイト作成に関する既知の問題 — 古い環境では Entra アプリ登録権限が必要な場合があります
• 削除したサイトの URL を再利用する場合 — リソースのパージに 30 分〜1 時間かかるため、待機が必要です
• サイト作成全般に関する FAQ

データを更新したがサイトに反映されない

• サーバーサイドキャッシュの仕組み — 反映 SLA は最大 15 分
• テーブルの Change Tracking が無効になっている
• 組織の Change Tracking が無効になっている

「Page Not Found」エラーが表示される

• Page Not Found サイトマーカーの設定不備
• 構成の問題 - Page Not Found サイトマーカー

特定のページが表示されない / 空白になる

• Web ページの構成に問題がある
• 親ページが非アクティブになっている
• Home サイトマーカーの設定不備
• Profile サイトマーカーの設定不備

サイトの読み込みが遅い

• パフォーマンスの問題（全般）
• CSS/JS が同期的に読み込まれている
• ルックアップがドロップダウン表示になっている
• Web ファイル数が多すぎる (500 件超)
• ヘッダー / フッターの出力キャッシュが無効になっている

ログインしていないユーザーにデータが表示されてしまう

• Basic Form / List の Table Permission が無効になっている
• OData フィードが匿名公開されている
• Dataverse テーブルへの匿名アクセスが許可されている

セキュリティ設定を強化したい

• Web Application Firewall (WAF) の有効化
• HTTP セキュリティヘッダーの設定
• Web Template Validation の有効化

その他の参考ドキュメント:

• 認証の概要
• SAML 2.0 FAQ
• Power Pages FAQ
• Known Issues

---

第 2 部: サポートへのお問い合わせ時にご用意いただきたい情報

上記のトラブルシューティングで解決しない場合は、Microsoft サポートへのお問い合わせをご検討ください。以下の情報を事前にご準備いただくことで、調査を迅速に進めることができます。

なお、後述させて頂く情報については、あらかじめすべての情報をご用意いただく必要があるわけではございませんので、採取可能な情報をあらかじめご用意いただけますと幸いです。

また、本ページにてご紹介させて頂いている情報以外の提供をサポートにて依頼させて頂く場合がございますので、予めご了承いただけますと幸いです。

3. 全般的に必要な情報

すべてのお問い合わせで以下の情報をご用意ください。

#	項目	確認方法
1	サイト URL	例: https://contoso.powerappsportals.com
2	環境 ID	環境の組織 ID と名前を確認する方法
3	問題の発生日時 (UTC)	タイムゾーンを明記。可能な限り正確に
4	問題の再現手順	具体的な操作手順を番号付きで記載。画面録画も有効です — Snipping Tool を使って画面を録画する方法
5	期待される動作と実際の動作	何が起きるべきで、何が起きたか
6	影響範囲	全ユーザーか特定ユーザーか / 全ページか特定ページか
7	スクリーンショット / エラーメッセージ	エラー画面のスクリーンショット、Activity ID があれば記載
8	最近の変更内容	問題発生前に行った設定変更・カスタマイズ・ソリューションインポート等
9	データモデルの種類	拡張データモデル (Enhanced) か 標準データモデル (Standard) か — Enhanced data model の確認方法

4. 問題カテゴリ別の追加情報

4.1 サイトが起動しない / サーバーエラー

#	追加情報	説明
1	エラー画面のスクリーンショット	エラーページ全体のキャプチャ（Activity ID やエラーメッセージが含まれるようにしてください）
2	環境に対する最近の操作	URL 変更、バックアップ復元、管理モードの有効/無効化 等
3	HAR ファイル	エラー発生時の HAR ファイル（取得手順はセクション 5 を参照）

4.2 認証・ログインの問題

#	追加情報	説明
1	エラー画面のスクリーンショット	ブラウザに表示されるエラーページ全体のキャプチャ
2	使用している認証プロバイダー	Microsoft Entra ID / Azure AD B2C / SAML 2.0 / ローカル認証 等
3	HAR ファイル	ブラウザの開発者ツール > Network タブで問題を再現し、HAR ファイルとして保存
4	影響を受けるユーザーの情報	全ユーザーか特定ユーザーか。特定の場合は Contact レコードの GUID
5	IDP 側の設定情報	Reply URL、Issuer URL、Client ID（秘密情報は含めないでください）

HAR ファイルの取得方法: ブラウザで F12 > Network タブを開く > Preserve log にチェック > 問題を再現 > Export HAR で保存

4.3 フォーム・リスト・Liquid の問題

#	追加情報	説明
1	エラー画面のスクリーンショット	問題が発生しているページ全体のキャプチャ
2	問題が発生するページの URL	具体的なページ URL
3	Basic Form / List の名前と対象テーブル	Portal Management App で確認できるフォーム/リストの名前、および対象の Dataverse テーブル名 (論理名)
4	HAR ファイル	問題のページにアクセスした際の HAR ファイル
5	DevTools 拡張機能のエラーログ	Power Pages タブに表示されるエラーメッセージ
6	カスタム Liquid コード	問題に関連する Web Template / Content Snippet のコード（該当する場合）
7	ブラウザコンソールのログ	F12 > Console タブ > コンソール領域内を右クリック > Save as… で .log ファイルとして保存

4.4 パフォーマンスの問題

#	追加情報	説明
1	遅いページの URL	特定のページか全体か
2	問題が発生する時間帯	常時か特定の時間帯か
3	HAR ファイル	遅いページにアクセスした際の HAR ファイル
4	ブラウザの Performance プロファイル	F12 > Performance タブ > 記録ボタン (●) をクリック > 問題を再現 > 停止 > 左上の ↓ (Export) アイコンで .json ファイルとして保存
5	CDN / WAF の設定状況	有効/無効、外部 CDN (Azure Front Door 等) の利用有無
6	同期プラグインの有無	対象テーブルに登録されているプラグインの種類と実行タイミング

4.5 Design Studio / 管理画面の問題

#	追加情報	説明
1	エラー画面のスクリーンショット	Design Studio で表示されるエラー画面全体のキャプチャ
2	ブラウザの種類とバージョン	Edge / Chrome 等、バージョン番号
3	操作しているユーザーの権限	システム管理者 / Maker 等
4	HAR ファイル	Design Studio で問題を再現した際の HAR ファイル
5	ブラウザコンソールのログ	F12 > Console タブ > コンソール領域内を右クリック > Save as… で .log ファイルとして保存

---

5. HAR ファイルの取得手順

多くのお問い合わせで HAR ファイル の提供をお願いしています。以下の手順で取得してください。

Microsoft Edge / Google Chrome の場合

1. 問題が発生するページを開く
2. F12 キーを押して開発者ツールを開く
3. Network タブを選択
4. Preserve log (ログを保持) にチェックを入れる
5. ページを更新して問題を再現
6. Network タブ内を右クリック > Save all as HAR with content を選択
7. ファイルを保存

参照: Dynamics 365 トラブルシューティングのための情報収集ガイド

注意: HAR ファイルにはセッション情報や Cookie が含まれる場合があります。サポートチケットの添付ファイルとして安全にご送付ください。

6. サポートインタンスのご提供

事前にご用意いただく情報ではございませんが、Power Pages 関連のお問い合わせではサポートインスタンスのご提供を依頼させて頂く場合がございます。

Power Pages に関する設定はレコードとして保存されているため、お客様環境において「どのようなカスタマイズを実装いただいているか」をまとめて確認させて頂く場合については、サポートインスタンスのご提供をお願いさせて頂く場合がございます。

参照: サポートインスタンスの提供

---

まとめ

トラブルシューティングのフローチャート

問題発生
│
├─ 1. Site Checker を実行
│     → 問題が検出されたら提示された手順で修正
│
├─ 2. DevTools 拡張機能でサーバーエラーを確認
│     → エラーメッセージから原因を特定
│
├─ 3. キャッシュクリア（15分待機 or /_services/about）
│     → 設定変更が反映されない場合に有効
│
├─ 4. Known Issues ページを確認
│     → 既知の問題と回避策がないか確認
│
└─ 5. 上記で解決しない場合 → サポートへお問い合わせ
       → 第 2 部の情報をご準備ください

参考リンク

リソース	URL
Power Pages 公式ドキュメント	https://learn.microsoft.com/power-pages/
Known Issues	https://learn.microsoft.com/power-pages/known-issues
FAQ	https://learn.microsoft.com/power-pages/faq
Site Checker	https://learn.microsoft.com/power-pages/admin/site-checker
DevTools 拡張機能	https://learn.microsoft.com/power-pages/configure/devtools-addon
サーバーサイドキャッシュ	https://learn.microsoft.com/power-pages/admin/clear-server-side-cache
認証の概要	https://learn.microsoft.com/power-pages/security/authentication/
Power Pages ブログ	https://powerpages.microsoft.com/en-us/blog/
コミュニティ	https://powerusers.microsoft.com/t5/Microsoft-Power-Pages-Community/ct-p/MPPCommunity

注意事項（情報の更新可能性）

本記事の内容は執筆日時点の公開情報に基づいております。仕様や UI、制限事項は将来変更される可能性がございます。最新情報は公式ドキュメントをご確認くださいますようお願い申し上げます。

※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります。