大网数据广告活动
Microsoft Graph 接口

organizationalBrandingProperties 资源类型

· 52CE 我爱测

包含组织品牌打造的详细信息。

命名空间:microsoft.graph

公开用于配置组织品牌的属性的抽象类型。

组织可以自定义Azure Active Directory (Azure AD) 登录页面,当用户登录到其组织的租户特定应用时,或当用户Azure AD用户名标识用户的租户时,会显示这些页面。 开发人员还可以阅读公司的品牌信息并自定义其应用体验,以使用其公司的品牌专门为登录用户定制它。

不能更改由 organizationalBranding 对象表示的原始配置语言。 但是,公司可以基于区域设置添加不同的品牌。 有关特定语言的品牌,请参阅 organizationalBrandingLocalization 对象。

Note: 添加自定义品牌打造需要你拥有 Azure Active Directory (Azure AD) 高级版 1、高级版 2 或 Office 365 (Office 365许可证) 应用。 有关许可和版本详细信息,请参阅注册Azure AD Premium。

Azure AD Premium全球实例为中国客户提供 Azure Active Directory。 Azure AD Premium由世纪银行在中国运营的 Azure 服务中目前不支持任何版本。 有关详细信息,请通过 Azure Active Directory论坛与我们联系。

方法

|无。

属性

属性 类型 说明
backgroundColor String 将出现在低带宽连接中的背景图像上的颜色。 我们建议你使用横幅徽标的主要颜色或你的组织颜色。 以十六进制格式指定此参数,例如,white 为 #FFFFFF 。
backgroundImage Stream 显示为登录页背景的图像。 允许的类型是 PNG 或 JPEG,不小于 300 KB 且不超过 1920 × 1080 像素。 较小的图像将降低带宽要求,并加快页面加载速度。
backgroundImageRelativeUrl String backgroundImage 属性的相对 URL,与 cdnList CDN基 URL 结合使用以提供由 CDN。 只读。
bannerLogo Stream 显示在登录页上的公司徽标的横幅版本。 允许的类型为 PNG 或 JPEG,不超过 36 × 245 像素。 我们建议使用透明图像,徽标周围没有填充。
bannerLogoRelativeUrl String bannerLogo 属性的相对 URL,与 cdnList CDN基 URL 结合使用以提供由 CDN 提供的只读CDN。 只读。
cdnList 字符串集合 提供当前资源资产的所有可用CDN提供程序的基 URL 列表。 多个CDN提供程序同时用于读取请求的高可用性。 只读。
id String 表示使用区域性名称指定的区域设置的标识符。 区域性名称遵循 RFC 1766 标准,格式为"languagecode2-country/regioncode2",其中"languagecode2"是派生自 ISO 639-1 的大写两字母代码,而"country/regioncode2"是派生自 ISO 3166 的大写两字母代码。 例如,美国英语为 en-US 。 默认 /branding 的 ID 始终为 String 0 类型或 default 。 只读。 注意: 目前不支持单个区域设置的多个品牌。
signInPageText String 显示在登录框底部的文本。 您可以使用此信息来传达其他信息,例如电话号码到技术支持或法律声明。 此文本必须是 Unicode 且不超过 1024 个字符。
squareLogo Stream 现现Windows 10 OOBE (和启用 Windows Autopilot 进行部署时) 显示公司徽标的正方形版本。 允许的类型为 PNG 或 JPEG,不超过 240 x 240 像素,大小不超过 10 KB。 我们建议使用透明图像,徽标周围没有填充。
squareLogoRelativeUrl String squareLogo 属性的相对 URL,与 cdnList CDN基 URL 结合使用以提供由 CDN。 只读。
usernameHintText String 在登录屏幕的用户名文本框中显示为提示的字符串。 此文本必须是不带链接或代码的 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"
}

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 AlexanderMars)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。