Создание intuneBrandingProfile

Статья
04/18/2024

Пространство имен: microsoft.graph

Важный: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Создайте новый объект intuneBrandingProfile .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	DeviceManagementApps.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Приложение	DeviceManagementApps.ReadWrite.All

HTTP-запрос

POST /deviceManagement/intuneBrandingProfiles

Заголовки запроса

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept	application/json

Текст запроса

В тексте запроса укажите представление объекта intuneBrandingProfile в формате JSON.

В следующей таблице показаны свойства, необходимые при создании intuneBrandingProfile.

Свойство	Тип	Описание
id	String	Ключ профиля
profileName	String	Имя профиля
profileDescription	String	Описание профиля
isDefaultProfile	Логический	Логическое значение, представляющее, используется ли профиль по умолчанию
createdDateTime	DateTimeOffset	Время создания brandingProfile
lastModifiedDateTime	DateTimeOffset	Время последнего изменения brandingProfile
displayName	String	Название компании или организации, отображаемое для конечных пользователей
themeColor	rgbColor;	Основной цвет темы, используемый в приложениях корпоративного портала и веб-портале
showLogo	Логический	Логическое значение, представляющее, отображаются ли предоставленные администратором изображения логотипа
showDisplayNameNextToLogo	Логический	Логическое значение, представляющее, будет ли отображаемое имя, предоставленное администратором, отображаться рядом с изображением логотипа
themeColorLogo	mimeContent;	Изображение логотипа, отображаемое в приложениях корпоративного портала с цветовым фоном темы за логотипом
lightBackgroundLogo	mimeContent;	Изображение логотипа, отображаемое в приложениях корпоративного портала с светлым фоном за логотипом
landingPageCustomizedImage	mimeContent;	Настраиваемое изображение, отображаемое на целевой странице приложений корпоративного портала
contactITName	String	Имя лица или организации, ответственного за ИТ-поддержку
contactITPhoneNumber	String	Номер телефона лица или организации, ответственного за ИТ-поддержку
contactITEmailAddress	String	Адрес электронной почты лица или организации, ответственного за ИТ-поддержку
contactITNotes	String	Текстовые комментарии, касающиеся лица или организации, ответственных за ИТ-поддержку
onlineSupportSiteUrl	String	URL-адрес сайта ит-службы поддержки компании или организации
onlineSupportSiteName	String	Отображаемое имя сайта ит-службы поддержки компании или организации
privacyUrl	String	URL-адрес политики конфиденциальности компании или организации
customPrivacyMessage	String	Текстовые комментарии о том, к чему администратор не имеет доступа на устройстве
customCanSeePrivacyMessage	String	Текстовые комментарии о том, к чему администратор имеет доступ на устройстве
customCantSeePrivacyMessage	String	Текстовые комментарии о том, к чему администратор не имеет доступа на устройстве
isRemoveDeviceDisabled	Логический	Логическое значение, указывающее, отключил ли администратор действие "Удалить устройство" на корпоративных устройствах.
isFactoryResetDisabled	Логический	Логическое значение, указывающее, отключил ли администратор действие "Сброс фабрики" на корпоративных устройствах.
companyPortalBlockedActions	Коллекция companyPortalBlockedAction	Коллекция заблокированных действий на корпоративном портале в зависимости от типов владения платформой и устройствами.
disableDeviceCategorySelection	Логический	Логическое значение, указывающее, будет ли отображаться выбор категории устройства на корпоративном портале
showAzureADEnterpriseApps	Логический	Логическое значение, указывающее, будут ли отображаться корпоративные приложения AzureAD на корпоративном портале
showOfficeWebApps	Логический	Логическое значение, указывающее, будут ли отображаться веб-приложения Office на корпоративном портале
showConfigurationManagerApps	Логический	Логическое значение, указывающее, будут ли отображаться приложения Configuration Manager на корпоративном портале
sendDeviceOwnershipChangePushNotification	Логический	Логическое значение, указывающее, отправляется ли пользователям push-уведомление при изменении типа владения устройством с личного на корпоративное.
enrollmentAvailability	enrollmentAvailabilityOptions	Настраиваемый поток регистрации устройств, отображаемый для конечного пользователя . Возможные значения: `availableWithPrompts`, `availableWithoutPrompts`, `unavailable`.
disableClientTelemetry	Логический	Применяется к данным телеметрии, отправляемых от всех клиентов в службу Intune. Если этот параметр отключен, все предупреждения об упреждающем устранении неполадок и проблемах в клиенте отключаются, а параметры телеметрии кажутся неактивными или скрытыми для пользователя устройства.
roleScopeTagIds	Коллекция строк	Список тегов области, назначенных профилю фирменной символики

Отклик

В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект intuneBrandingProfile в теле отклика.

Пример

Запрос

Ниже приведен пример запроса.

POST https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles
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 201 Created
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"
  ]
}

Поделиться через

Создание intuneBrandingProfile

Разрешения

HTTP-запрос

Заголовки запроса

Текст запроса

Отклик

Пример

Запрос

Отклик

Обратная связь

Дополнительные ресурсы