Обновление androidDeviceOwnerEnrollmentProfile

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

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

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

Обновите свойства объекта androidDeviceOwnerEnrollmentProfile .

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

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

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}

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

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

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

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

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

Свойство	Тип	Описание
accountId	String	GUID клиента, которому принадлежит профиль регистрации.
id	String	Уникальный GUID профиля регистрации.
displayName	String	Отображаемое имя для профиля регистрации.
description	String	Описание профиля регистрации.
enrollmentMode	androidDeviceOwnerEnrollmentMode	Режим регистрации устройств, использующих этот профиль регистрации. Возможные значения: corporateOwnedDedicatedDevice, corporateOwnedFullyManaged, corporateOwnedWorkProfile, corporateOwnedAOSPUserlessDevice, corporateOwnedAOSPUserAssociatedDevice.
enrollmentTokenType	androidDeviceOwnerEnrollmentTokenType	Тип маркера регистрации для профиля регистрации. Возможные значения: default, corporateOwnedDedicatedDeviceWithAzureADSharedMode, deviceStaging.
createdDateTime	DateTimeOffset	Дата и время создания профиля регистрации.
lastModifiedDateTime	DateTimeOffset	Дата и время последнего изменения профиля регистрации.
tokenValue	String	Значение последнего созданного маркера для этого профиля регистрации.
tokenCreationDateTime	DateTimeOffset	Дата создания последнего созданного маркера.
tokenExpirationDateTime	DateTimeOffset	Дата и время, когда истекает срок действия последнего созданного маркера.
enrolledDeviceCount	Int32	Общее количество устройств с Android, зарегистрированных через этот профиль регистрации.
enrollmentTokenUsageCount	Int32	Общее количество устройств AOSP, зарегистрированных с помощью текущего маркера.
qrCodeContent	String	Строка, используемая для создания QR-кода маркера.
qrCodeImage	mimeContent	Строка, используемая для создания QR-кода маркера.
roleScopeTagIds	Коллекция строк	Список тегов области для этого экземпляра сущности.
configureWifi	Логический	Логическое значение, указывающее, что Wi-Fi сеть должна быть настроена во время подготовки устройства. Если задано значение TRUE, подготовка устройств будет использовать Wi-Fi связанные свойства для автоматического подключения к Wi-Fi сетям. Если задано значение FALSE или undefined, другие Wi-Fi связанные свойства будут игнорироваться. Значение по умолчанию — TRUE. Возвращается по умолчанию.
wifiSsid	String	Строка, содержащая ssid для входа wi-fi.
wifiPassword	String	Строка, содержащая пароль для входа в Wi-Fi
wifiSecurityType	aospWifiSecurityType	Строка, содержащая тип безопасности Wi-Fi. Возможные значения: none, wpa, wep.
wifiHidden	Логический	Логическое значение, указывающее, включены ли скрытые сети Wi-Fi.
isTeamsDeviceProfile	Логический	Логическое значение, указывающее, является ли этот профиль профилем устройства Android AOSP для Teams.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код ответа и обновленный объект androidDeviceOwnerEnrollmentProfile в теле отклика.

Пример

Запрос

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

PATCH https://graph.microsoft.com/beta/deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}
Content-type: application/json
Content-length: 981

{
  "@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
  "accountId": "Account Id value",
  "displayName": "Display Name value",
  "description": "Description value",
  "enrollmentMode": "corporateOwnedFullyManaged",
  "enrollmentTokenType": "corporateOwnedDedicatedDeviceWithAzureADSharedMode",
  "tokenValue": "Token Value value",
  "tokenCreationDateTime": "2017-01-01T00:01:38.5314127-08:00",
  "tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
  "enrolledDeviceCount": 3,
  "enrollmentTokenUsageCount": 9,
  "qrCodeContent": "Qr Code Content value",
  "qrCodeImage": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "configureWifi": true,
  "wifiSsid": "Wifi Ssid value",
  "wifiPassword": "Wifi Password value",
  "wifiSecurityType": "wpa",
  "wifiHidden": true,
  "isTeamsDeviceProfile": true
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1153

{
  "@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
  "accountId": "Account Id value",
  "id": "a8d0245e-245e-a8d0-5e24-d0a85e24d0a8",
  "displayName": "Display Name value",
  "description": "Description value",
  "enrollmentMode": "corporateOwnedFullyManaged",
  "enrollmentTokenType": "corporateOwnedDedicatedDeviceWithAzureADSharedMode",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "tokenValue": "Token Value value",
  "tokenCreationDateTime": "2017-01-01T00:01:38.5314127-08:00",
  "tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
  "enrolledDeviceCount": 3,
  "enrollmentTokenUsageCount": 9,
  "qrCodeContent": "Qr Code Content value",
  "qrCodeImage": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "configureWifi": true,
  "wifiSsid": "Wifi Ssid value",
  "wifiPassword": "Wifi Password value",
  "wifiSecurityType": "wpa",
  "wifiHidden": true,
  "isTeamsDeviceProfile": true
}