重要
SharePoint アドインは、2026 年 4 月 2 日に SharePoint Online のサポートが終了しました。 SharePoint でホストされているアドインとプロバイダーでホストされているアドインはどちらも廃止され、政府機関向けクラウドを含む SharePoint Online では機能しなくなります。 アドインの開発、展開、使用に関するガイダンスは、新しい SharePoint Online ソリューション用ではなく、履歴参照と該当する SharePoint Server シナリオ用に保持されます。
オンプレミスのアプリ カタログを通じて展開された SharePoint Server アドインは、この変更によって廃止されません。 パブリック マーケットプレースからの SharePoint アドインの取得は、SharePoint Server の 2026 年 4 月 2 日に終了しました。
この廃止により、SharePoint REST API、CSOM、JSOM、または SharePoint Framework (SPFx) は廃止されません。 SharePoint Online の場合は、ユーザー インターフェイス拡張機能に SPFx を使用し、外部アプリケーションへの認証に Microsoft Entra ID を使用します。 廃止のお知らせとアドインの移行ガイダンスを参照してください。
重要
このガイダンスは、従来の SharePoint エクスペリエンスと SharePoint アドイン モデルに適用されます。 カスタム マスター ページは、最新の SharePoint Online エクスペリエンスではサポートされておらず、従来のカスタマイズ アプローチと見なされます。
新しい SharePoint アドイン モデルで SharePoint サイトにカスタム マスター ページを実装する方法は、完全信頼コード / ファーム ソリューションの場合とは異なります。 一般的な完全信頼コード (FTC) ファーム / ソリューション シナリオでは、カスタム マスター ページはカスタム ブランドを実装するよう作成されます。 マスター ページは通常、宣言型コードと FTC / ファーム ソリューションを使用してマスター ページを展開し、それらを SharePoint サイトに登録します。
SharePoint アドイン モデルのブランド化シナリオでは、カスタム マスター ページを使用できます。 リモート プロビジョニング パターンを使用して SharePoint サイトでカスタム マスター ページを展開して登録できます。
カスタム マスター ページの基本ガイドライン
カスタム マスター ページについては、大まかに次のような基本ガイドラインが提供されています。
- カスタム マスター ページを使用して SharePoint サイトをカスタマイズすることができますが、長期にわたる追加コストと将来の更新に関する課題が生じることに留意してください。
ほとんどの場合、テーマ、構成された外観、および代替 CSS により、一般的なすべてのブランド化シナリオを達成できます。
See the Branding SharePoint Sites (SharePoint Add-in Recipe) to learn all about the different branding options you have for SharePoint sites with the SharePoint Add-in model. The recipe will help you consider the short and long-term impact of customization from an operational and a maintenance perspective. 特定のブランド要件を実装するために、カスタム マスター ページは必要ないことがわかる場合があります。
カスタム マスター ページの使用を選択した場合は、主要な機能更新プログラムが Microsoft 365 に適用されたときにカスタム マスター ページに変更を適用する準備をしてください。
- カスタム マスター ページを SharePoint サイトに展開して登録するには、リモート プロビジョニングを使用します。
- 宣言型コードやサンドボックス コードを使用して、SharePoint サイトにマスター ページを展開および登録しないでください。
チーム サイトと発行サイト
どのような場合にカスタム マスター ページが必要となるでしょうか。
SharePoint サイトにカスタム ブランドを適用する場合、チーム サイトと発行サイトの両方をブランド化する必要があります。 一般に、オンプレミスと Microsoft 365 の両方のシナリオで SharePoint 上に構築されたイントラネットは、チーム サイトと発行サイトを組み合わせて使用します。
カスタム ブランドの要件では、多くの場合、テーマや JavaScript の埋め込み手法では実行できない特定のレイアウト変更が必要です。
このようなシナリオでは、通常、チーム サイトは、発行サイトほどの量のカスタム ブランドは必要ありません。また、すぐに使えるモバイル デバイス用の SharePoint Contemporary ビューで、チーム サイト用のモバイル デバイスをサポートするのに十分です。 このような場合、発行サイトにはカスタム マスター ページのみを使用し、AlternativeCSS およびカスタム SharePoint テーマ (*.spcolor ファイル)、フォント スキーム (*.spfont ファイル)、およびブランド チーム サイトには合成された外観として定義された背景画像を使用することをお勧めします。
展開に関する考慮事項
- カスタム マスター ページを 発行サイトに展開する場合は、カスタム マスター ページをルート サイトにのみ展開する必要があります。
- Provisioning.PublishingFeatures (PnP サンプル) は、カスタム マスター ページを発行サイトに展開する方法を示しています。
- 発行 サイト以外のサイトにカスタム マスター ページを展開する場合は、各サイトにカスタム マスター ページを展開する必要があります。
通常、カスタム マスター ページはサイトがプロビジョニングされるときに適用されます。 リモート プロビジョニング プロセスは、このアプローチによく適合します。 通常、Web ブラウザーを使用して SharePoint ブランドのカスタマイズを手動で適用する場合のみ、他のサイト コレクションやサブサイトを含めるように拡大する予定のない単一の SharePoint サイトのプロトタイプを作成または変更する場合のみです。
- その他の展開の詳細や追加サンプルについては、 (SharePoint アドイン レシピ) および サイト プロビジョニング (SharePoint アドイン レシピ) を参照してください。
SharePoint サイトのカスタム マスター ページおよびページ レイアウトの詳細
カスタム ブランド化の要件を実装する唯一の方法がカスタム マスター ページであるシナリオでは、カスタム マスター ページとページ レイアウトを作成することができます。 この記事の冒頭で述べた、このアプローチに関連する長期的なメンテナンスコストに関する点に留意してください。
- SharePoint サイト用のカスタム マスター ページを使用すると、最高レベルのカスタマイズ (無制限) を実行できます。
- SharePoint サイト用のカスタム マスター ページを短期および長期間にわたって実装およびメンテナンスするには、大量の時間が必要です。
- サービスの更新に伴うすぐに使用できるマスター ページへの変更は、カスタム マスター ページには反映されません。
- カスタム マスター ページはサイトごとのレベルで適用できます。
- カスタム マスター ページを使用する場合は、すぐに使用できるマスター ページの 1 つから始めて、ニーズに合わせて変更することをお勧めします。
- カスタム マスター ページで行うカスタマイズの量を最小限に抑えるようにしてください。これにより、すぐに使用できるマスター ページに対する Microsoft 365 サービスの変更をカスタム マスター ページにレプリケートする必要がある場合に、簡単に更新できます。
- SharePoint マスター ページには、削除してはならない必須コンテンツ プレースホルダーが多数あります。これを選択すると、ページがエラーになります。 必要なコンテンツ プレースホルダーを展開してサイトに割り当てた瞬間にエラーが表示されるため、必要なコンテンツ プレースホルダーを削除するとわかります。
SharePoint サイト用のカスタム マスター ページとページ レイアウトが適しているケース
このオプションは、ブランディングのニーズが固有の場合や、発行サイトを使用している場合に適しています。
推奨される展開アプローチ
- Web ブラウザーを使用してカスタム マスター ページを手動でアップロードし、構成された外観に手動で割り当てることができます。
- リモート プロビジョニング パターンを使用してカスタム マスター ページをアップロードし、SharePoint サイトに割り当てることもできます。
- その他の展開の詳細や追加サンプルについては、 (SharePoint アドイン レシピ) および サイト プロビジョニング (SharePoint アドイン レシピ) を参照してください。
関連リンク
- モジュール (SharePoint アドイン レシピ)
- サイト プロビジョニング (SharePoint アドイン レシピ)
- SharePoint サイトのブランド化 (SharePoint アドイン レシピ)
- Office 365 開発および SharePoint PnP ソリューション ガイダンスのガイダンス記事
PnP サンプル
- CSOM を使用したテーマ管理 (Microsoft 365 PnP サンプル)
- Web オブジェクトの AlternateCSSUrl プロパティと SiteLogoUrl プロパティ (PnP サンプル)
- テーマをサイトに設定する (PnP サンプル)
- SharePoint 用アプリでの SharePoint テーマの設定 (PnP サンプル)
- すぐに使用できるシアトル マスターの応答性を高める (PnP サンプル)
- サンプルとコンテンツ: https://github.com/pnp/PnP
適用対象
- Microsoft 365 マルチテナント (MT)
- Microsoft 365 専用 (D) 部分的に
- SharePoint 2013 オンプレミス - 一部
専用およびオンプレミスの場合のパターンは SharePoint アドイン モデル手法と同じですが、使用可能なテクノロジは異なる可能性があります。