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


Обновление windowsPhone81GeneralConfiguration

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

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

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

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

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

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

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

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

Тело запроса

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

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

Свойство Тип Описание
id String Ключ объекта. Наследуется от объекта deviceConfiguration.
lastModifiedDateTime DateTimeOffset Дата и время последнего изменения объекта. Наследуется от объекта deviceConfiguration.
createdDateTime DateTimeOffset Дата и время создания объекта. Наследуется от объекта deviceConfiguration.
description String Указанное администратором описание конфигурации устройства. Наследуется от объекта deviceConfiguration.
displayName String Указанное администратором имя конфигурации устройства. Наследуется от объекта deviceConfiguration.
version Int32 Версия конфигурации устройства. Наследуется от deviceConfiguration.
applyOnlyToWindowsPhone81 Boolean Указывает, применяется ли эта политика только к Windows Phone 8.1. Это свойство доступно только для чтения.
appsBlockCopyPaste Boolean Указывает, следует ли заблокировать копирование данных.
bluetoothBlocked Boolean Указывает, следует ли заблокировать Bluetooth.
cameraBlocked Boolean Указывает, следует ли заблокировать камеру.
cellularBlockWifiTethering Boolean Указывает, следует ли заблокировать модем Wi-Fi. Ни на что не влияет, если Wi-Fi заблокирован.
compliantAppsList Коллекция appListItem Список приложений, соответствующих требованиям (список разрешений или блокировок, определяется свойством CompliantAppListType). Эта коллекция может содержать не более 10 000 элементов.
compliantAppListType appListType Список, указанный с помощью свойства AppComplianceList. Возможные значения: none, appsInListCompliant, appsNotInListCompliant.
diagnosticDataBlockSubmission Boolean Указывает, следует ли заблокировать отправку диагностических данных.
emailBlockAddingAccounts Boolean Указывает, следует ли заблокировать пользовательские учетные записи электронной почты.
locationServicesBlocked Boolean Указывает, следует ли заблокировать службы определения местоположения.
microsoftAccountBlocked Boolean Указывает, следует ли запретить использовать учетную запись Майкрософт.
nfcBlocked Boolean Указывает, следует ли заблокировать NFC.
passwordBlockSimple Boolean Указывает, следует ли заблокировать синхронизацию календаря.
passwordExpirationDays Int32 Количество дней до окончания срока действия пароля.
passwordMinimumLength Int32 Минимальная длина паролей.
passwordMinutesOfInactivityBeforeScreenTimeout Int32 Время с момента последнего действия до отключения экрана (в минутах).
passwordMinimumCharacterSetCount Int32 Количество наборов символов, которые должен содержать пароль.
passwordPreviousPasswordBlockCount Int32 Количество предыдущих паролей, которые следует заблокировать. Допустимые значения: от 0 до 24.
passwordSignInFailureCountBeforeFactoryReset Int32 Количество неудачных попыток входа до восстановления заводских настроек.
passwordRequiredType requiredPasswordType Необходимый тип пароля. Возможные значения: deviceDefault, alphanumeric, numeric.
passwordRequired Boolean Указывает, обязательно ли использовать пароль.
screenCaptureBlocked Boolean Указывает, следует ли запретить делать снимки экрана.
storageBlockRemovableStorage Boolean Указывает, следует ли запретить использовать съемные носители.
storageRequireEncryption Boolean Указывает, обязательно ли шифрование.
webBrowserBlocked Boolean Указывает, следует ли заблокировать веб-браузер.
wifiBlocked Boolean Указывает, следует ли заблокировать Wi-Fi.
wifiBlockAutomaticConnectHotspots Boolean Указывает, следует ли заблокировать автоматическое подключение к хот-спотам Wi-Fi. Ни на что не влияет, если Wi-Fi заблокирован.
wifiBlockHotspotReporting Boolean Указывает, следует ли запретить устройству сообщать об обнаруженных хот-спотах Wi-Fi. Ни на что не влияет, если Wi-Fi заблокирован.
windowsStoreBlocked Boolean Указывает, следует ли заблокировать Microsoft Store.

Отклик

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

Пример

Запрос

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

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

{
  "@odata.type": "#microsoft.graph.windowsPhone81GeneralConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "applyOnlyToWindowsPhone81": true,
  "appsBlockCopyPaste": true,
  "bluetoothBlocked": true,
  "cameraBlocked": 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,
  "emailBlockAddingAccounts": true,
  "locationServicesBlocked": true,
  "microsoftAccountBlocked": true,
  "nfcBlocked": true,
  "passwordBlockSimple": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordMinimumCharacterSetCount": 0,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "alphanumeric",
  "passwordRequired": true,
  "screenCaptureBlocked": true,
  "storageBlockRemovableStorage": true,
  "storageRequireEncryption": true,
  "webBrowserBlocked": true,
  "wifiBlocked": true,
  "wifiBlockAutomaticConnectHotspots": true,
  "wifiBlockHotspotReporting": true,
  "windowsStoreBlocked": true
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.windowsPhone81GeneralConfiguration",
  "id": "f5e0e34d-e34d-f5e0-4de3-e0f54de3e0f5",
  "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,
  "applyOnlyToWindowsPhone81": true,
  "appsBlockCopyPaste": true,
  "bluetoothBlocked": true,
  "cameraBlocked": 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,
  "emailBlockAddingAccounts": true,
  "locationServicesBlocked": true,
  "microsoftAccountBlocked": true,
  "nfcBlocked": true,
  "passwordBlockSimple": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordMinimumCharacterSetCount": 0,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "alphanumeric",
  "passwordRequired": true,
  "screenCaptureBlocked": true,
  "storageBlockRemovableStorage": true,
  "storageRequireEncryption": true,
  "webBrowserBlocked": true,
  "wifiBlocked": true,
  "wifiBlockAutomaticConnectHotspots": true,
  "wifiBlockHotspotReporting": true,
  "windowsStoreBlocked": true
}