organizationalBrandingProperties リソースの種類

名前空間: microsoft.graph

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

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

組織 Branding オブジェクトで表される元の構成の言語を変更できない。 ただし、企業はロケールに基づいて異なるブランド化を追加できます。 言語固有のブランド化については 、「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してください

メソッド

|なし。

プロパティ

プロパティ 種類 説明
backgroundColor 文字列 低帯域幅接続の背景画像の代に表示される色。 バナー ロゴまたは組織の色の主な色を使用することをお勧めします。 これを 16 進形式で指定します。たとえば、白は #FFFFFF .
backgroundImage Stream サインイン ページの背景として表示されるイメージ。 許可される型は、300 KB 未満の PNG または JPEG で、1920 ピクセル未満× 1080 ピクセルです。 画像を小さくすると、帯域幅の要件が減り、ページの読み込み速度が速くなります。
backgroundImageRelativeUrl 文字列 cdnList の基本 URL と組み合CDN backgroundImage プロパティの相対URL を使用して、CDN。 読み取り専用です。
bannerLogo Stream サインイン ページに表示される会社のロゴのバナー バージョン。 使用できる型は、PNG または JPEG で、245 ピクセル× 36 未満です。 ロゴの周囲にパディングがない透明なイメージを使用することをお勧めします。
bannerLogoRelativeUrl 文字列 cdnList の CDN ベース URL と組み合わせて、CDN によって提供される読み取り専用バージョンを提供する bannerLogo プロパティの相対 URL。 読み取り専用。
cdnList String collection 現在のリソースの資産を提供CDN利用可能なすべてのプロバイダーの基本 URL の一覧。 複数CDNプロバイダーは、読み取り要求の高可用性のために同時に使用されます。 読み取り専用。
id 文字列 カルチャ名を使用して指定されたロケールを表す識別子。 カルチャ名は、"languagecode2-country/regioncode2" という形式の RFC 1766 標準に従います。"languagecode2" は ISO 639-1 から派生した小文字の 2 文字コードで、"country/regioncode2" は ISO 3166 から派生した大文字の 2 文字コードです。 たとえば、米国英語は en-US . 既定 の /branding の ID は、常に String 型 0 または default です。 読み取り専用です。

注: 1 つのロケールに対する複数のブランド化は現在サポートされていません。
signInPageText 文字列 サインイン ボックスの下部に表示されるテキスト。 これを使用して、電話番号などの追加情報をヘルプ デスクや法的声明に伝達できます。 このテキストは Unicode で、1024 文字を超えることはできません。
squareLogo Stream 既定のエクスペリエンス (OOBE) に表示される会社Windows 10ロゴの 2 乗バージョンと、Windows自動パイロットが展開に対して有効になっている場合。 許可される型は、PNG または JPEG のサイズが 240 x 240 ピクセル以下で、サイズが 10 KB 以下です。 ロゴの周囲にパディングがない透明なイメージを使用することをお勧めします。
squareLogoRelativeUrl 文字列 squareLogo プロパティの相対 URL で 、cdnList の CDN ベース URL と組み合わせて、CDN。 読み取り専用。
usernameHintText 文字列 サインイン画面のユーザー名テキスト ボックスにヒントとして表示される文字列。 このテキストは、リンクやコードのない Unicode で、64 文字を超えることはできません。

リレーションシップ

なし。

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"
}