Обновление androidWorkProfileGeneralDeviceConfiguration

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

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

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

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

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

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

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

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

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

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

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

Свойство Тип Описание
id String Ключ объекта. Наследуется от объекта deviceConfiguration.
lastModifiedDateTime DateTimeOffset Дата и время последнего изменения объекта. Наследуется от объекта deviceConfiguration.
createdDateTime DateTimeOffset Дата и время создания объекта. Наследуется от объекта deviceConfiguration.
description String Указанное администратором описание конфигурации устройства. Наследуется от объекта deviceConfiguration.
displayName String Указанное администратором имя конфигурации устройства. Наследуется от объекта deviceConfiguration.
version Int32 Версия конфигурации устройства. Наследуется от объекта deviceConfiguration.
passwordBlockFingerprintUnlock Boolean Указывает, следует ли запретить разблокировку с помощью отпечатка пальца.
passwordBlockTrustAgents Boolean Указывает, следует ли блокировать Smart Lock и другие агенты безопасности.
passwordExpirationDays Int32 Количество дней до окончания срока действия пароля. Допустимые значения: от 1 до 365.
passwordMinimumLength Int32 Минимальная длина паролей. Допустимые значения: от 4 до 16.
passwordMinutesOfInactivityBeforeScreenTimeout Int32 Время с момента последнего действия до отключения экрана (в минутах).
passwordPreviousPasswordBlockCount Int32 Количество предыдущих паролей, которые следует заблокировать. Допустимые значения: от 0 до 24.
passwordSignInFailureCountBeforeFactoryReset Int32 Количество неудачных попыток входа до восстановления заводских настроек. Допустимые значения от 1 до 16
passwordRequiredType androidWorkProfileRequiredPasswordType Требуемый тип пароля. Возможные значения: deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric, alphanumericWithSymbols.
workProfileDataSharingType androidWorkProfileCrossProfileDataSharingType Разрешенный тип общего доступа к данным. Возможные значения: deviceDefault, preventAny, allowPersonalToWork, noRestrictions.
workProfileBlockNotificationsTimeDeviceLocked Логический Указывает, следует ли блокировать уведомления во время блокировки устройства.
workProfileBlockAddingAccounts Логический Запретить пользователям добавлять или удалять учетные записи в рабочем профиле.
workProfileBluetoothEnableContactSharing Логический Разрешите устройствам Bluetooth доступ к корпоративным контактам.
workProfileBlockScreenCapture Логический Блокировка снимка экрана в рабочем профиле.
workProfileBlockCrossProfileCallerId Логический Блокировать отображение идентификатора вызывающего рабочего профиля в личном профиле.
workProfileBlockCamera Логический Блокировать камеру рабочего профиля.
workProfileBlockCrossProfileContactsSearch Логический Блокировать доступность контактов рабочего профиля в личном профиле.
workProfileBlockCrossProfileCopyPaste Логический Логическое значение, указывающее, включен ли параметр запретить копирование и вставку между профилями.
workProfileDefaultAppPermissionPolicy androidWorkProfileDefaultAppPermissionPolicyType Требуемый тип пароля. Возможные значения: deviceDefault, prompt, autoGrant, autoDeny.
workProfilePasswordBlockFingerprintUnlock Логический Указывает, следует ли блокировать разблокировку отпечатка пальца для рабочего профиля.
workProfilePasswordBlockTrustAgents Логический Указывает, следует ли блокировать смарт-блокировку и другие агенты доверия для рабочего профиля.
workProfilePasswordExpirationDays Int32 Количество дней до истечения срока действия пароля рабочего профиля. Допустимые значения: от 1 до 365.
workProfilePasswordMinimumLength Int32 Минимальная длина пароля рабочего профиля. Допустимые значения: от 4 до 16.
workProfilePasswordMinNumericCharacters Int32 Минимальное число числовых символов, необходимых в пароле рабочего профиля. Допустимые значения от 1 до 10
workProfilePasswordMinNonLetterCharacters Int32 Минимальное количество символов, не относящихся к буквам, необходимых в пароле рабочего профиля. Допустимые значения от 1 до 10
workProfilePasswordMinLetterCharacters Int32 Минимальное число букв, необходимых в пароле рабочего профиля. Допустимые значения от 1 до 10
workProfilePasswordMinLowerCaseCharacters Int32 Минимальное число символов в нижнем регистре, необходимых в пароле рабочего профиля. Допустимые значения от 1 до 10
workProfilePasswordMinUpperCaseCharacters Int32 Минимальное число символов в верхнем регистре, необходимое в пароле рабочего профиля. Допустимые значения от 1 до 10
workProfilePasswordMinSymbolCharacters Int32 Минимальное число символов, необходимых в пароле рабочего профиля. Допустимые значения от 1 до 10
workProfilePasswordMinutesOfInactivityBeforeScreenTimeout Int32 Время с момента последнего действия до отключения экрана (в минутах).
workProfilePasswordPreviousPasswordBlockCount Int32 Количество предыдущих паролей рабочего профиля, которые необходимо заблокировать. Допустимые значения: от 0 до 24.
workProfilePasswordSignInFailureCountBeforeFactoryReset Int32 Количество разрешенных ошибок входа до удаления рабочего профиля и удаления всех корпоративных данных. Допустимые значения от 1 до 16
workProfilePasswordRequiredType androidWorkProfileRequiredPasswordType Тип необходимого пароля рабочего профиля. Возможные значения: deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric, alphanumericWithSymbols.
workProfileRequirePassword Логический Пароль требуется или не требуется для рабочего профиля
securityRequireVerifyApps Boolean Указывает, что требуется включить функцию проверки приложений для Android.

Отклик

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

Пример

Запрос

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

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1831

{
  "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockTrustAgents": true,
  "workProfilePasswordExpirationDays": 1,
  "workProfilePasswordMinimumLength": 0,
  "workProfilePasswordMinNumericCharacters": 7,
  "workProfilePasswordMinNonLetterCharacters": 9,
  "workProfilePasswordMinLetterCharacters": 6,
  "workProfilePasswordMinLowerCaseCharacters": 9,
  "workProfilePasswordMinUpperCaseCharacters": 9,
  "workProfilePasswordMinSymbolCharacters": 6,
  "workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
  "workProfilePasswordPreviousPasswordBlockCount": 13,
  "workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": true
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
  "id": "6decda7e-da7e-6dec-7eda-ec6d7edaec6d",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockTrustAgents": true,
  "workProfilePasswordExpirationDays": 1,
  "workProfilePasswordMinimumLength": 0,
  "workProfilePasswordMinNumericCharacters": 7,
  "workProfilePasswordMinNonLetterCharacters": 9,
  "workProfilePasswordMinLetterCharacters": 6,
  "workProfilePasswordMinLowerCaseCharacters": 9,
  "workProfilePasswordMinUpperCaseCharacters": 9,
  "workProfilePasswordMinSymbolCharacters": 6,
  "workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
  "workProfilePasswordPreviousPasswordBlockCount": 13,
  "workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": true
}