organizationalBrandingProperties リソースの種類

名前空間: microsoft.graph

organizationのブランド化を構成するためのプロパティを公開する抽象型。

組織は、ユーザーがorganizationのテナント固有のアプリにサインインするとき、またはユーザーのテナントをユーザー名から識別Microsoft Entra ID場合に表示されるMicrosoft Entraサインイン ページをカスタマイズできます。 開発者は、会社のブランド化情報を読み取り、自社のブランド化を使用してサインイン ユーザー専用にカスタマイズするようにアプリ エクスペリエンスをカスタマイズすることもできます。

組織ブランド オブジェクトで表される元の構成の言語 を 変更することはできません。 ただし、企業はロケールに基づいて異なるブランドを追加できます。 言語固有のブランド化については、 組織のブランド化Localization オブジェクトに関するページを 参照してください。

注:

カスタム ブランド化を追加するには、Microsoft Entra ID P1 または P2、Premium 2、または Office 365 (Office 365 アプリの場合) のライセンスが必要です。 ライセンスとエディションの詳細については、「Microsoft Entra ID P1 または P2 にサインアップする」を参照してください。

Microsoft Entra ID P1 または P2 エディションは、Microsoft Entra IDの世界的なインスタンスを使用して、中国のお客様にご利用いただけます。 Microsoft Entra ID P1 または P2 エディションは、現在、中国の 21Vianet が運営する Azure サービスではサポートされていません。 詳細については、Microsoft Entra フォーラムを使用して、お問い合わせください。

メソッド

|なし。

プロパティ

プロパティ	種類	説明
backgroundColor	String	低帯域幅接続で背景イメージの代わりに表示される色。 バナー ロゴの原色またはorganizationの色を使用することをお勧めします。 これを 16 進形式で指定します。たとえば、white は #FFFFFFです。
backgroundImage	Stream	サインイン ページの背景として表示される画像。 使用できる種類は、300 KB 未満で、1920 × 1080 ピクセル以下の PNG または JPEG です。 イメージを小さくすると、帯域幅の要件が減り、ページの読み込みが速くなります。
backgroundImageRelativeUrl	String	cdnList の CDN ベース URL と組み合わせて CDN によって提供されるバージョンを提供する backgroundImage プロパティの相対 URL。 読み取り専用。
bannerLogo	Stream	サインイン ページに表示される会社のロゴのバナー バージョン。 使用できる種類は、36 × 245 ピクセル以下の PNG または JPEG です。 ロゴの周囲にパディングのない透明なイメージを使用することをお勧めします。
bannerLogoRelativeUrl	String	cdnList の CDN ベース URL と組み合わせて CDN によって提供される読み取り専用バージョンを提供する bannerLogo プロパティの相対 URL。 読み取り専用。
cdnList	String collection	現在のリソースの資産を提供しているすべての利用可能な CDN プロバイダーのベース URL の一覧。 読み取り要求の高可用性のために、複数の CDN プロバイダーが同時に使用されます。 読み取り専用です。
contentCustomization	contentCustomization	テナントの認証フロー全体でカスタマイズするコンテンツ オプションを表します。 メモ：外部テナントのMicrosoft Entra 外部 IDでのみサポートされます。
customAccountResetCredentialsUrl	String	アカウント資格情報をリセットするためのカスタム URL。 この URL は ASCII 形式であるか、ASCII 以外の文字は URL エンコードされ、128 文字を超えない必要があります。
customCannotAccessYourAccountText	String	サインイン ページの既定の "アカウントにアクセスできません" セルフサービス パスワード リセット (SSPR) ハイパーリンク テキストを置き換える文字列。 このテキストは Unicode 形式で、256 文字以内にする必要があります。
customCannotAccessYourAccountUrl	String	サインイン ページのセルフサービス パスワード リセット (SSPR) の "アカウントにアクセスできません" ハイパーリンクの既定の URL を置き換えるカスタム URL。 この URL は ASCII 形式であるか、ASCII 以外の文字は URL エンコードされ、128 文字を超えない必要があります。 使用しないでください。 代わりに customAccountResetCredentialsUrl を 使用します。
customCSS	Stream	サインイン ページに表示される CSS スタイル。 使用できる形式は .css フォーマットのみであり、25 KB 以下です。
customCSSRelativeUrl	String	cdnList の CDN ベース URL と組み合わせて CDN によって提供されるバージョンを提供する customCSS プロパティの相対 URL。 読み取り専用。
customForgotMyPasswordText	String	サインイン フォームの既定の "パスワードを忘れた場合" ハイパーリンク テキストを置き換える文字列。 このテキストは Unicode 形式で、256 文字以内にする必要があります。
customPrivacyAndCookiesText	String	フッターの既定の "プライバシーと Cookie" ハイパーリンク テキストを置き換える文字列。 このテキストは Unicode 形式で、256 文字以内にする必要があります。
customPrivacyAndCookiesUrl	String	フッターの "プライバシーと Cookie" ハイパーリンクの既定の URL を置き換えるカスタム URL。 この URL は ASCII 形式であるか、ASCII 以外の文字は URL エンコードされ、128 文字を超えない必要があります。
customResetItNowText	String	サインイン フォームの既定の "今すぐリセット" ハイパーリンク テキストを置き換える文字列。 このテキストは Unicode 形式で、256 文字以内にする必要があります。 使用しないでください。 "今すぐリセット" ハイパーリンク テキストのカスタマイズは現在サポートされていません。
customTermsOfUseText	String	フッターの既定の "使用条件" ハイパーリンク テキストを置き換える文字列。 このテキストは Unicode 形式で、256 文字以内にする必要があります。
customTermsOfUseUrl	String	フッターの "使用条件" ハイパーリンクの既定の URL を置き換えるカスタム URL。 この URL は ASCII 形式である必要があります。または ASCII 以外の文字は URL エンコードされ、128 文字を超えないようにする必要があります。
ファビコン	Stream	Microsoft Entra テナントの既定の Microsoft 製品 favicon を置き換えるカスタム アイコン (favicon)。
faviconRelativeUrl	String	上記の favicon の相対 URL。cdnList の CDN ベース URL と組み合わせて 、CDN によって提供されるバージョンを提供します。 読み取り専用です。
headerBackgroundColor	String	ヘッダーの色をカスタマイズするために適用する RGB 色。
headerLogo	Stream	サインイン ページのヘッダーに表示される会社のロゴ。 使用できる種類は、36 × 245 ピクセル以下の PNG または JPEG です。 ロゴの周囲にパディングのない透明なイメージを使用することをお勧めします。
headerLogoRelativeUrl	String	cdnList の CDN ベース URL と組み合わせて CDN によって提供される読み取り専用バージョンを提供する headerLogo プロパティの相対 URL。 読み取り専用です。
id	String	カルチャ名を使用して指定されたロケールを表す識別子。 カルチャ名は、"languagecode2-country/regioncode2" という形式の RFC 1766 標準に従います。"languagecode2" は ISO 639-1 から派生した小文字の 2 文字のコードであり、"country/regioncode2" は ISO 3166 から派生した大文字の 2 文字コードです。 たとえば、米国英語は です en-US。 既定の /branding の ID は、常に String 型 0 または です default。 読み取り専用。 メモ： 現在、1 つのロケールに対する複数のブランド化はサポートされていません。
loginPageLayoutConfiguration	loginPageLayoutConfiguration	テナントのログイン ページに表示されるレイアウト構成を表します。
loginPageTextVisibilitySettings	loginPageTextVisibilitySettings	テナントのログイン ページで非表示にできるさまざまなテキストを表します。
signInPageText	String	サインイン ボックスの下部に表示されるテキスト。 電話番号などの追加情報をヘルプ デスクや法的な声明に伝える場合に使用します。 このテキストは Unicode 形式で、1024 文字以内にする必要があります。
squareLogo	Stream	Windows 10アウトオブボックス エクスペリエンス (OOBE) と Windows Autopilot が展開に有効になっている場合に表示される、正方形のバージョンの会社のロゴ。 使用できる種類は、240 x 240 ピクセル以下で、サイズが 10 KB 以下の PNG または JPEG です。 ロゴの周囲にパディングのない透明なイメージを使用することをお勧めします。
squareLogoRelativeUrl	String	cdnList の CDN ベース URL と組み合わせて CDN によって提供されるバージョンを提供する squareLogo プロパティの相対 URL。 読み取り専用。
squareLogoDark	Stream	Windows 10アウトオブボックス エクスペリエンス (OOBE) と Windows Autopilot が展開に有効になっている場合に表示される会社のロゴの正方形の濃色バージョン。 使用できる種類は、240 x 240 ピクセル以下で、サイズが 10 KB 以下の PNG または JPEG です。 ロゴの周囲にパディングのない透明なイメージを使用することをお勧めします。
squareLogoDarkRelativeUrl	String	cdnList の CDN ベース URL と組み合わせて CDN によって提供されるバージョンを提供する squareLogoDark プロパティの相対 URL。 読み取り専用。
usernameHintText	String	サインイン画面の [ユーザー名] テキスト ボックスにヒントとして表示される文字列。 このテキストは、リンクやコードを含まない Unicode である必要があり、64 文字を超えることはできません。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
    "@odata.type": "#microsoft.graph.organizationalBrandingProperties",
  "id": "String (identifier)",
  "backgroundColor": "String",
  "backgroundImage": "Stream",
  "backgroundImageRelativeUrl": "String",
  "bannerLogo": "Stream",
  "bannerLogoRelativeUrl": "String",
  "cdnList": [
    "String"
  ],
  "contentCustomization": {
    "@odata.type": "microsoft.graph.contentCustomization"
  }, 
  "signInPageText": "String",
  "squareLogo": "Stream",
  "squareLogoRelativeUrl": "String",
  "squareLogoDark": "Stream",
  "squareLogoDarkRelativeUrl": "String",
  "usernameHintText": "String",
  "customAccountResetCredentialsUrl": "String",
  "customCannotAccessYourAccountText": "String",
  "customCannotAccessYourAccountUrl": "String",
  "customCSS": "Stream",
  "customCSSRelativeUrl": "String",
  "customForgotMyPasswordText": "String",
  "customPrivacyAndCookiesText": "String",
  "customPrivacyAndCookiesUrl": "String",
  "customResetItNowText": "String",
  "customTermsOfUseText": "String",
  "customTermsOfUseUrl": "String",
  "favicon": "Stream",
  "faviconRelativeUrl": "String",
  "headerBackgroundColor": "String",
  "headerLogo": "Stream",
  "headerLogoRelativeUrl": "String",
  "loginPageLayoutConfiguration": {
    "@odata.type": "microsoft.graph.loginPageLayoutConfiguration"
  },
  "loginPageTextVisibilitySettings": {
    "@odata.type": "microsoft.graph.loginPageTextVisibilitySettings"
  }
}