organizationalBranding リソースの種類

名前空間: microsoft.graph

組織の既定のブランド化に関する詳細が含まれる。 組織 BrandingProperties から継承します。

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

元の構成の言語を変更できない。 ただし、企業はロケールに基づいて異なるブランド化を追加できます。 言語固有のブランド化については 、「organizationalBrandingLocalization オブジェクト」を参照 してください。

注意

カスタム ブランド化を追加するには、Azure Active Directory (Azure AD) プレミアム 1、プレミアム 2、または Office 365 (Office 365 アプリの場合) のライセンスが必要です。 ライセンスとエディションの詳細については、「サインアップする」を参照Azure AD Premium。

Azure AD Premiumの世界規模のインスタンスを使用している中国のお客様は、Azure Active Directory。 Azure AD Premium 21Vianet が運営する Azure サービスでは、現在、エディションはサポートされていません。 詳細については、「フォーラム」を使用してAzure Active Directoryしてください。

メソッド

メソッド	戻り値の種類	説明
organizationalBranding の取得	organizationalBranding	組織のBranding オブジェクトのプロパティ とリレーションシップを読み取 る。
organizationalbranding の更新	なし	組織の Branding オブジェクトのプロパティを更新 します。

プロパティ

プロパティ	種類	説明
backgroundColor	文字列	低帯域幅接続の背景画像の代に表示される色。 バナー ロゴまたは組織の色の主な色を使用することをお勧めします。 これを 16 進形式で指定します。たとえば、白は #FFFFFF . 組織 BrandingProperties から継承されます。
backgroundImage	Stream	サインイン ページの背景として表示されるイメージ。 許可される型は、300 KB 未満の PNG または JPEG で、1920 ピクセル未満× 1080 ピクセルです。 画像を小さくすると、帯域幅の要件が減り、ページの読み込み速度が速くなります。 組織 BrandingProperties から継承されます。 $select でのみ返されます。
backgroundImageRelativeUrl	文字列	cdnList の基本 URL と組み合CDN backgroundImage プロパティの相対URL を使用して、CDN。 読み取り専用。 組織 BrandingProperties から継承されます。
bannerLogo	Stream	サインイン ページに表示される会社のロゴのバナー バージョン。 使用できる型は、PNG または JPEG で、245 ピクセル× 36 未満です。 ロゴの周囲にパディングがない透明なイメージを使用することをお勧めします。 組織 BrandingProperties から継承されます。 $select でのみ返されます。
bannerLogoRelativeUrl	文字列	cdnList の CDN ベース URL と組み合わせて、CDN によって提供される読み取り専用バージョンを提供する bannerLogo プロパティの相対 URL。 読み取り専用です。 組織 BrandingProperties から継承されます。
cdnList	String collection	現在のリソースの資産を提供CDN利用可能なすべてのプロバイダーの基本 URL の一覧。 複数CDNプロバイダーは、読み取り要求の高可用性のために同時に使用されます。 読み取り専用。 組織 BrandingProperties から継承されます。
id	文字列	カルチャ名を使用して指定されたロケールを表す識別子。 カルチャ名は、"languagecode2-country/regioncode2" という形式の RFC 1766 標準に従います。"languagecode2" は ISO 639-1 から派生した小文字の 2 文字コードで、"country/regioncode2" は ISO 3166 から派生した大文字の 2 文字コードです。 たとえば、米国英語は en-US . 既定 の /branding の ID は、常に String 型 0 または default です。 読み取り専用。 注: 1 つのロケールに対する複数のブランド化は現在サポートされていません。 組織 BrandingProperties から継承されます。
signInPageText	文字列	サインイン ボックスの下部に表示されるテキスト。 これを使用して、電話番号などの追加情報をヘルプ デスクや法的声明に伝達できます。 このテキストは Unicode で、1024 文字を超えることはできません。 組織 BrandingProperties から継承されます。
squareLogo	Stream	既定のエクスペリエンス (OOBE) に表示される会社Windows 10ロゴの 2 乗バージョンと、Windows自動パイロットが展開に対して有効になっている場合。 許可される型は、PNG または JPEG のサイズが 240 x 240 ピクセル以下で、サイズが 10 KB 以下です。 ロゴの周囲にパディングがない透明なイメージを使用することをお勧めします。 組織 BrandingProperties から継承されます。 $select でのみ返されます。
squareLogoRelativeUrl	文字列	squareLogo プロパティの相対 URL で 、cdnList の CDN ベース URL と組み合わせて、CDN。 読み取り専用。 組織 BrandingProperties から継承されます。
usernameHintText	文字列	サインイン画面のユーザー名テキスト ボックスにヒントとして表示される文字列。 このテキストは、リンクやコードのない Unicode で、64 文字を超えることはできません。 組織 BrandingProperties から継承されます。

リレーションシップ

リレーションシップ	型	説明
ローカライズ	organizationalBrandingLocalizationコレクション	ロケールに基づいて異なるブランド化を追加します。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.organizationalBranding",
  "id": "String (identifier)",
  "backgroundColor": "String",
  "backgroundImage": "Stream",
  "backgroundImageRelativeUrl": "String",
  "bannerLogo": "Stream",
  "bannerLogoRelativeUrl": "String",
  "cdnList": [
    "String"
  ],
  "signInPageText": "String",
  "squareLogo": "Stream",
  "squareLogoRelativeUrl": "String",
  "usernameHintText": "String"
}