更新 intuneBrandingProfile
命名空间:microsoft.graph
重要: Microsoft /beta 版本下的 Graph API 可能会发生更改;不支持生产使用。
注意:适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
更新 intuneBrandingProfile 对象的属性。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
权限
要调用此 API,需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限。
权限类型 | 权限(从最低特权到最高特权) |
---|---|
委派(工作或学校帐户) | DeviceManagementApps.ReadWrite.All |
委派(个人 Microsoft 帐户) | 不支持。 |
应用程序 | DeviceManagementApps.ReadWrite.All |
HTTP 请求
PATCH /deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}
请求标头
标头 | 值 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
接受 | application/json |
请求正文
在请求正文中,提供 intuneBrandingProfile 对象的 JSON 表示形式。
下表显示了创建 intuneBrandingProfile 时所需的属性。
属性 | 类型 | 说明 |
---|---|---|
id | String | 配置文件密钥 |
profileName | String | 配置文件的名称 |
profileDescription | String | 配置文件的说明 |
isDefaultProfile | 布尔值 | 表示配置文件是否用作默认配置文件的布尔值 |
createdDateTime | DateTimeOffset | 创建 BrandingProfile 的时间 |
lastModifiedDateTime | DateTimeOffset | 上次修改 BrandingProfile 的时间 |
displayName | String | 显示给最终用户的公司/组织名称 |
themeColor | rgbColor | 公司门户应用程序和 Web 门户中使用的主主题颜色 |
showLogo | 布尔值 | 表示是否显示管理员提供的徽标图像的布尔值 |
showDisplayNameNextToLogo | 布尔值 | 布尔值,表示管理员提供的显示名称是否显示在徽标图像旁边 |
themeColorLogo | mimeContent | 徽标图像显示在公司门户应用中,这些应用在徽标后面具有主题颜色背景 |
lightBackgroundLogo | mimeContent | 徽标图像显示在公司门户应用中,这些应用在徽标后面具有浅色背景 |
landingPageCustomizedImage | mimeContent | 公司门户应用登陆页中显示的自定义图像 |
contactITName | String | 负责 IT 支持的人员/组织的名称 |
contactITPhoneNumber | String | 负责 IT 支持的人员/组织的电话号码 |
contactITEmailAddress | String | 负责 IT 支持的人员/组织的电子邮件地址 |
contactITNotes | String | 有关负责 IT 支持的人员/组织的文本注释 |
onlineSupportSiteUrl | String | 公司/组织的 IT 支持站点的 URL |
onlineSupportSiteName | String | 公司/组织的 IT 支持站点的显示名称 |
privacyUrl | String | 公司/组织的隐私策略 URL |
customPrivacyMessage | String | 有关管理员无权访问设备上的内容的文本注释 |
customCanSeePrivacyMessage | String | 有关管理员有权访问设备上的内容的文本注释 |
customCantSeePrivacyMessage | String | 有关管理员无权访问设备上的内容的文本注释 |
isRemoveDeviceDisabled | 布尔值 | 表示管理员是否在公司拥有的设备上禁用了“删除设备”操作的布尔值。 |
isFactoryResetDisabled | 布尔值 | 表示管理员是否已在公司拥有的设备上禁用“恢复出厂设置”操作的布尔值。 |
companyPortalBlockedActions | companyPortalBlockedAction 集合 | 根据平台和设备所有权类型收集公司门户中阻止的操作。 |
disableDeviceCategorySelection | 布尔值 | 指示设备类别选择是否将显示在公司门户中的布尔值 |
showAzureADEnterpriseApps | 布尔值 | 指示 AzureAD 企业应用是否将显示在公司门户中的布尔值 |
showOfficeWebApps | 布尔值 | 指示 Office WebApps 是否将显示在公司门户中的布尔值 |
showConfigurationManagerApps | 布尔值 | 指示 Configuration Manager 应用是否将显示在公司门户中的布尔值 |
sendDeviceOwnershipChangePushNotification | 布尔值 | 指示当用户的设备所有权类型从个人更改为企业时是否向用户发送推送通知的布尔值 |
enrollmentAvailability | enrollmentAvailabilityOptions | 向最终用户显示的自定义设备注册流。 可取值为:availableWithPrompts 、availableWithoutPrompts 、unavailable 。 |
disableClientTelemetry | 布尔值 | 适用于从所有客户端发送到 Intune 服务的遥测数据。 禁用后,客户端中的所有主动故障排除和问题警告都会关闭,并且遥测设置对设备用户显示为非活动或隐藏状态。 |
roleScopeTagIds | 字符串集合 | 分配给品牌配置文件的范围标记列表 |
响应
如果成功,此方法在响应正文中返回响应 200 OK
代码和更新的 intuneBrandingProfile 对象。
示例
请求
下面是一个请求示例。
PATCH https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId}
Content-type: application/json
Content-length: 2059
{
"@odata.type": "#microsoft.graph.intuneBrandingProfile",
"profileName": "Profile Name value",
"profileDescription": "Profile Description value",
"isDefaultProfile": true,
"displayName": "Display Name value",
"themeColor": {
"@odata.type": "microsoft.graph.rgbColor",
"r": 1,
"g": 1,
"b": 1
},
"showLogo": true,
"showDisplayNameNextToLogo": true,
"themeColorLogo": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"lightBackgroundLogo": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"landingPageCustomizedImage": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"contactITName": "Contact ITName value",
"contactITPhoneNumber": "Contact ITPhone Number value",
"contactITEmailAddress": "Contact ITEmail Address value",
"contactITNotes": "Contact ITNotes value",
"onlineSupportSiteUrl": "https://example.com/onlineSupportSiteUrl/",
"onlineSupportSiteName": "Online Support Site Name value",
"privacyUrl": "https://example.com/privacyUrl/",
"customPrivacyMessage": "Custom Privacy Message value",
"customCanSeePrivacyMessage": "Custom Can See Privacy Message value",
"customCantSeePrivacyMessage": "Custom Cant See Privacy Message value",
"isRemoveDeviceDisabled": true,
"isFactoryResetDisabled": true,
"companyPortalBlockedActions": [
{
"@odata.type": "microsoft.graph.companyPortalBlockedAction",
"platform": "androidForWork",
"ownerType": "company",
"action": "remove"
}
],
"disableDeviceCategorySelection": true,
"showAzureADEnterpriseApps": true,
"showOfficeWebApps": true,
"showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true,
"enrollmentAvailability": "availableWithoutPrompts",
"disableClientTelemetry": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}
响应
下面是一个响应示例。 注意:为简洁起见,可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2231
{
"@odata.type": "#microsoft.graph.intuneBrandingProfile",
"id": "fcd6136c-136c-fcd6-6c13-d6fc6c13d6fc",
"profileName": "Profile Name value",
"profileDescription": "Profile Description value",
"isDefaultProfile": true,
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"displayName": "Display Name value",
"themeColor": {
"@odata.type": "microsoft.graph.rgbColor",
"r": 1,
"g": 1,
"b": 1
},
"showLogo": true,
"showDisplayNameNextToLogo": true,
"themeColorLogo": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"lightBackgroundLogo": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"landingPageCustomizedImage": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"contactITName": "Contact ITName value",
"contactITPhoneNumber": "Contact ITPhone Number value",
"contactITEmailAddress": "Contact ITEmail Address value",
"contactITNotes": "Contact ITNotes value",
"onlineSupportSiteUrl": "https://example.com/onlineSupportSiteUrl/",
"onlineSupportSiteName": "Online Support Site Name value",
"privacyUrl": "https://example.com/privacyUrl/",
"customPrivacyMessage": "Custom Privacy Message value",
"customCanSeePrivacyMessage": "Custom Can See Privacy Message value",
"customCantSeePrivacyMessage": "Custom Cant See Privacy Message value",
"isRemoveDeviceDisabled": true,
"isFactoryResetDisabled": true,
"companyPortalBlockedActions": [
{
"@odata.type": "microsoft.graph.companyPortalBlockedAction",
"platform": "androidForWork",
"ownerType": "company",
"action": "remove"
}
],
"disableDeviceCategorySelection": true,
"showAzureADEnterpriseApps": true,
"showOfficeWebApps": true,
"showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true,
"enrollmentAvailability": "availableWithoutPrompts",
"disableClientTelemetry": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}