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


Update androidGeneralDeviceConfiguration

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

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

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

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

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

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

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

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

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

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

В приведенной ниже таблице показаны свойства, которые необходимо указывать при создании объекта androidGeneralDeviceConfiguration.

Свойство Тип Описание
id String Ключ объекта. Наследуется от объекта deviceConfiguration.
lastModifiedDateTime DateTimeOffset Дата и время последнего изменения объекта. Наследуется от объекта deviceConfiguration.
createdDateTime DateTimeOffset Дата и время создания объекта. Наследуется от объекта deviceConfiguration.
description String Указанное администратором описание конфигурации устройства. Наследуется от объекта deviceConfiguration.
displayName String Указанное администратором имя конфигурации устройства. Наследуется от объекта deviceConfiguration.
version Int32 Версия конфигурации устройства. Наследуется от объекта deviceConfiguration
appsBlockClipboardSharing Boolean Указывает, следует ли запретить совместное использование буфера обмена для копирования данных между приложениями.
appsBlockCopyPaste Boolean Указывает, следует ли запретить копирование данных между приложениями.
appsBlockYouTube Boolean Указывает, следует ли заблокировать приложение YouTube.
bluetoothBlocked Boolean Указывает, следует ли заблокировать Bluetooth.
cameraBlocked Boolean Указывает, следует ли запретить использовать камеру.
cellularBlockDataRoaming Boolean Указывает, следует ли блокировать передачу данных в роуминге.
cellularBlockMessaging Boolean Указывает, следует ли запретить обмениваться SMS и MMS.
cellularBlockVoiceRoaming Boolean Указывает, следует ли заблокировать голосовой роуминг.
cellularBlockWiFiTethering Boolean Указывает, следует ли блокировать синхронизацию модема Wi-Fi.
compliantAppsList Коллекция appListItem Список приложений, соответствующих требованиям (список разрешений или блокировок, определяется свойством CompliantAppListType). Эта коллекция может содержать не более 10 000 элементов.
compliantAppListType appListType Тип списка, определенного свойством CompliantAppsList. Возможные значения: none, appsInListCompliant, appsNotInListCompliant.
diagnosticDataBlockSubmission Boolean Указывает, следует ли заблокировать отправку диагностических данных.
locationServicesBlocked Boolean Указывает, следует ли заблокировать службы определения местоположения.
googleAccountBlockAutoSync Boolean Указывает, следует ли блокировать автоматическую синхронизацию учетной записи Google.
googlePlayStoreBlocked Boolean Указывает, следует ли блокировать Google Play Маркет.
kioskModeBlockSleepButton Boolean Указывает, следует ли блокировать кнопку спящего режима экрана в режиме терминала.
kioskModeBlockVolumeButtons Boolean Указывает, следует ли блокировать кнопки громкости в режиме терминала.
kioskModeApps Коллекция appListItem Список разрешенных приложений в режиме терминала. Эта коллекция может содержать не более 500 элементов.
nfcBlocked Boolean Указывает, следует ли заблокировать NFC.
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 androidRequiredPasswordType Требуемый тип пароля. Возможные значения: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.
passwordRequired Boolean Указывает, обязательно ли использовать пароль.
powerOffBlocked Boolean Указывает, следует ли блокировать отключение устройства.
factoryResetBlocked Boolean Указывает, следует ли запретить пользователю восстанавливать заводские настройки.
screenCaptureBlocked Boolean Указывает, следует ли запретить делать снимки экрана.
deviceSharingAllowed Boolean Указывает, следует ли разрешить режим совместного доступа к устройству.
storageBlockGoogleBackup Boolean Указывает, следует ли блокировать резервное копирование Google.
storageBlockRemovableStorage Boolean Указывает, следует ли запретить использовать съемные носители.
storageRequireDeviceEncryption Boolean Указывает, обязательно ли шифрование устройства.
storageRequireRemovableStorageEncryption Boolean Указывает, обязательно ли шифрование съемных носителей.
voiceAssistantBlocked Boolean Указывает, следует ли блокировать использование голосового помощника.
voiceDialingBlocked Boolean Указывает, следует ли заблокировать голосовой набор.
webBrowserBlockPopups Boolean Указывает, следует ли блокировать всплывающие окна в веб-браузере.
webBrowserBlockAutofill Boolean Указывает, следует ли заблокировать функцию автозаполнения в веб-браузере.
webBrowserBlockJavaScript Boolean Указывает, следует ли заблокировать JavaScript в веб-браузере.
webBrowserBlocked Boolean Указывает, следует ли заблокировать веб-браузер.
webBrowserCookieSettings webBrowserCookieSettings Настройки файлов cookie в веб-браузере. Возможные значения: browserDefault, blockAlways, allowCurrentWebSite, allowFromWebsitesVisited, allowAlways.
wiFiBlocked Boolean Указывает, следует ли заблокировать синхронизацию Wi-Fi.
appsInstallAllowList Коллекция appListItem Список приложений, которые можно установить на устройстве KNOX. Эта коллекция может содержать не более 500 элементов.
appsLaunchBlockList Коллекция appListItem Список приложений, которые запрещено запускать на устройстве KNOX. Эта коллекция может содержать не более 500 элементов.
appsHideList Коллекция appListItem Список приложений, которые следует скрыть на устройстве KNOX. Эта коллекция может содержать не более 500 элементов.
securityRequireVerifyApps Boolean Указывает, что требуется включить функцию проверки приложений для Android.

Ответ

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

Пример

Запрос

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

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

{
  "@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "appsBlockClipboardSharing": true,
  "appsBlockCopyPaste": true,
  "appsBlockYouTube": true,
  "bluetoothBlocked": true,
  "cameraBlocked": true,
  "cellularBlockDataRoaming": true,
  "cellularBlockMessaging": true,
  "cellularBlockVoiceRoaming": true,
  "cellularBlockWiFiTethering": true,
  "compliantAppsList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "compliantAppListType": "appsInListCompliant",
  "diagnosticDataBlockSubmission": true,
  "locationServicesBlocked": true,
  "googleAccountBlockAutoSync": true,
  "googlePlayStoreBlocked": true,
  "kioskModeBlockSleepButton": true,
  "kioskModeBlockVolumeButtons": true,
  "kioskModeApps": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "nfcBlocked": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "alphabetic",
  "passwordRequired": true,
  "powerOffBlocked": true,
  "factoryResetBlocked": true,
  "screenCaptureBlocked": true,
  "deviceSharingAllowed": true,
  "storageBlockGoogleBackup": true,
  "storageBlockRemovableStorage": true,
  "storageRequireDeviceEncryption": true,
  "storageRequireRemovableStorageEncryption": true,
  "voiceAssistantBlocked": true,
  "voiceDialingBlocked": true,
  "webBrowserBlockPopups": true,
  "webBrowserBlockAutofill": true,
  "webBrowserBlockJavaScript": true,
  "webBrowserBlocked": true,
  "webBrowserCookieSettings": "blockAlways",
  "wiFiBlocked": true,
  "appsInstallAllowList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "appsLaunchBlockList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "appsHideList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "securityRequireVerifyApps": true
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
  "id": "9e00d534-d534-9e00-34d5-009e34d5009e",
  "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,
  "appsBlockClipboardSharing": true,
  "appsBlockCopyPaste": true,
  "appsBlockYouTube": true,
  "bluetoothBlocked": true,
  "cameraBlocked": true,
  "cellularBlockDataRoaming": true,
  "cellularBlockMessaging": true,
  "cellularBlockVoiceRoaming": true,
  "cellularBlockWiFiTethering": true,
  "compliantAppsList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "compliantAppListType": "appsInListCompliant",
  "diagnosticDataBlockSubmission": true,
  "locationServicesBlocked": true,
  "googleAccountBlockAutoSync": true,
  "googlePlayStoreBlocked": true,
  "kioskModeBlockSleepButton": true,
  "kioskModeBlockVolumeButtons": true,
  "kioskModeApps": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "nfcBlocked": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "alphabetic",
  "passwordRequired": true,
  "powerOffBlocked": true,
  "factoryResetBlocked": true,
  "screenCaptureBlocked": true,
  "deviceSharingAllowed": true,
  "storageBlockGoogleBackup": true,
  "storageBlockRemovableStorage": true,
  "storageRequireDeviceEncryption": true,
  "storageRequireRemovableStorageEncryption": true,
  "voiceAssistantBlocked": true,
  "voiceDialingBlocked": true,
  "webBrowserBlockPopups": true,
  "webBrowserBlockAutofill": true,
  "webBrowserBlockJavaScript": true,
  "webBrowserBlocked": true,
  "webBrowserCookieSettings": "blockAlways",
  "wiFiBlocked": true,
  "appsInstallAllowList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "appsLaunchBlockList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "appsHideList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "securityRequireVerifyApps": true
}