Update managedDeviceEncryptionState

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

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

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

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

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

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

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/managedDeviceEncryptionStates/{managedDeviceEncryptionStateId}

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

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

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

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

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

Свойство	Тип	Описание
id	String	Ключ объекта.
userPrincipalName	String	Имя пользователя
deviceType	deviceTypes	Платформа устройства. Возможные значения: desktop, , windowsRT, winMO6, windowsPhonenokia, , mac, winEmbeddedwinCE, iPhone, iPadiPodandroidiSocConsumer, unix, macMDM, holoLens, , surfaceHub, androidForWork, androidEnterprise, , blackberry, . unknownpalm
osVersion	String	Версия операционной системы устройства
tpmSpecificationVersion	String	Версия доверенного платформенного модуля устройства
deviceName	String	Имя устройства
encryptionReadinessState	encryptionReadinessState	Состояние готовности шифрования. Возможные значения: notReady, ready.
encryptionState	encryptionState	Состояние шифрования устройства. Возможные значения: notEncrypted, encrypted.
encryptionPolicySettingState	complianceStatus	Состояние параметра политики шифрования. Возможные значения: unknown, notApplicable, compliant, remediated, nonCompliant, error, conflict, notAssigned.
advancedBitLockerStates	advancedBitLockerState	Расширенное состояние BitLocker. Возможные значения: success, , noUserConsent, osVolumeTpmRequiredosVolumeUnprotected, osVolumeTpmOnlyRequired, osVolumeTpmPinRequired, , osVolumeTpmStartupKeyRequired, osVolumeEncryptionMethodMismatchosVolumeTpmPinStartupKeyRequired, , recoveryKeyBackupFailed, fixedDriveNotEncrypted, fixedDriveEncryptionMethodMismatch, loggedOnUserNonAdmin, , windowsRecoveryEnvironmentNotConfigured, tpmNotAvailable, , tpmNotReady. networkError
fileVaultStates	fileVaultState	Состояние FileVault. Возможные значения: success, driveEncryptedByUser, userDeferredEncryption, escrowNotEnabled.
policyDetails	коллекция encryptionReportPolicyDetails	Сведения о политике

Отклик

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

Пример

Запрос

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

PATCH https://graph.microsoft.com/beta/deviceManagement/managedDeviceEncryptionStates/{managedDeviceEncryptionStateId}
Content-type: application/json
Content-length: 704

{
  "@odata.type": "#microsoft.graph.managedDeviceEncryptionState",
  "userPrincipalName": "User Principal Name value",
  "deviceType": "windowsRT",
  "osVersion": "Os Version value",
  "tpmSpecificationVersion": "Tpm Specification Version value",
  "deviceName": "Device Name value",
  "encryptionReadinessState": "ready",
  "encryptionState": "encrypted",
  "encryptionPolicySettingState": "notApplicable",
  "advancedBitLockerStates": "noUserConsent",
  "fileVaultStates": "driveEncryptedByUser",
  "policyDetails": [
    {
      "@odata.type": "microsoft.graph.encryptionReportPolicyDetails",
      "policyId": "Policy Id value",
      "policyName": "Policy Name value"
    }
  ]
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.managedDeviceEncryptionState",
  "id": "f09b4ab6-4ab6-f09b-b64a-9bf0b64a9bf0",
  "userPrincipalName": "User Principal Name value",
  "deviceType": "windowsRT",
  "osVersion": "Os Version value",
  "tpmSpecificationVersion": "Tpm Specification Version value",
  "deviceName": "Device Name value",
  "encryptionReadinessState": "ready",
  "encryptionState": "encrypted",
  "encryptionPolicySettingState": "notApplicable",
  "advancedBitLockerStates": "noUserConsent",
  "fileVaultStates": "driveEncryptedByUser",
  "policyDetails": [
    {
      "@odata.type": "microsoft.graph.encryptionReportPolicyDetails",
      "policyId": "Policy Id value",
      "policyName": "Policy Name value"
    }
  ]
}