profile 安卓work_更新 androidWorkProfileCompliancePolicy

更新 androidWorkProfileCompliancePolicyUpdate androidWorkProfileCompliancePolicy

2020/9/22

本文内容

命名空间：microsoft.graphNamespace: microsoft.graph

注意： 适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

先决条件Prerequisites

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

权限类型Permission type

权限(从最高特权到最低特权)Permissions (from most to least privileged)

委派(工作或学校帐户)Delegated (work or school account)

DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

委派(个人 Microsoft 帐户)Delegated (personal Microsoft account)

不支持。Not supported.

应用程序Application

不支持。Not supported.

HTTP 请求HTTP Request

PATCH /deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}

请求标头Request headers

标头Header

值Value

AuthorizationAuthorization

Bearer 。必需。Bearer Required.

接受Accept

application/jsonapplication/json

请求正文Request body

In the request body, supply a JSON representation for the androidWorkProfileCompliancePolicy object.

The following table shows the properties that are required when you create the androidWorkProfileCompliancePolicy.

属性Property

类型Type

说明Description

idid

StringString

createdDateTimecreatedDateTime

DateTimeOffsetDateTimeOffset

创建对象的日期/时间。DateTime the object was created.

descriptiondescription

StringString

管理员提供的设备配置的说明。Admin provided description of the Device Configuration.

lastModifiedDateTimelastModifiedDateTime

DateTimeOffsetDateTimeOffset

上次修改对象的日期/时间。DateTime the object was last modified.

displayNamedisplayName

StringString

管理员提供的设备配置的名称。Admin provided name of the device configuration.

versionversion

Int32Int32

设备配置的版本。Version of the device configuration.

passwordRequiredpasswordRequired

BooleanBoolean

需要密码才可解锁设备。Require a password to unlock device.

passwordMinimumLengthpasswordMinimumLength

Int32Int32

最短密码长度。Minimum password length. 有效值为 4 至 16Valid values 4 to 16

passwordRequiredTypepasswordRequiredType

密码中的字符类型。Type of characters in password. 可取值为：deviceDefault、alphabetic、alphanumeric、alphanumericWithSymbols、lowSecurityBiometric、numeric、numericComplex、any。Possible values are: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.

passwordMinutesOfInactivityBeforeLockpasswordMinutesOfInactivityBeforeLock

Int32Int32

在需要密码之前不活动的分钟数。Minutes of inactivity before a password is required.

passwordExpirationDayspasswordExpirationDays

Int32Int32

密码过期前的天数。Number of days before the password expires. 有效值为 1 至 365Valid values 1 to 365

passwordPreviousPasswordBlockCountpasswordPreviousPasswordBlockCount

Int32Int32

要阻止的以前密码的数量。Number of previous passwords to block. 有效值为 1 至 24Valid values 1 to 24

securityPreventInstallAppsFromUnknownSourcessecurityPreventInstallAppsFromUnknownSources

BooleanBoolean

要求设备不允许安装来自未知源的应用。Require that devices disallow installation of apps from unknown sources.

securityDisableUsbDebuggingsecurityDisableUsbDebugging

BooleanBoolean

在 Android 设备上禁用 USB 调试。Disable USB debugging on Android devices.

securityRequireVerifyAppssecurityRequireVerifyApps

BooleanBoolean

要求启用 Android 验证应用功能。Require the Android Verify apps feature is turned on.

deviceThreatProtectionEnableddeviceThreatProtectionEnabled

BooleanBoolean

要求设备已启用设备威胁防护。Require that devices have enabled device threat protection.

deviceThreatProtectionRequiredSecurityLeveldeviceThreatProtectionRequiredSecurityLevel

要求移动威胁防护最低风险级别来报告不符合情况。Require Mobile Threat Protection minimum risk level to report noncompliance. 可取值为：unavailable、secured、low、medium、high、notSet。Possible values are: unavailable, secured, low, medium, high, notSet.

securityBlockJailbrokenDevicessecurityBlockJailbrokenDevices

BooleanBoolean

设备不得越狱或取得 root 权限。Devices must not be jailbroken or rooted.

osMinimumVersionosMinimumVersion

StringString

最低 Android 版本。Minimum Android version.

osMaximumVersionosMaximumVersion

StringString

最高 Android 版本。Maximum Android version.

minAndroidSecurityPatchLevelminAndroidSecurityPatchLevel

StringString

最低 Android 安全修补程序级别。Minimum Android security patch level.

storageRequireEncryptionstorageRequireEncryption

BooleanBoolean

要求对 Android 设备加密。Require encryption on Android devices.

securityRequireSafetyNetAttestationBasicIntegritysecurityRequireSafetyNetAttestationBasicIntegrity

BooleanBoolean

要求设备传递 SafetyNet 基本完整性检查。Require the device to pass the SafetyNet basic integrity check.

securityRequireSafetyNetAttestationCertifiedDevicesecurityRequireSafetyNetAttestationCertifiedDevice

BooleanBoolean

要求设备传递 SafetyNet 认证设备检查。Require the device to pass the SafetyNet certified device check.

securityRequireGooglePlayServicessecurityRequireGooglePlayServices

BooleanBoolean

要求在设备上安装并启用 Google Play Services。Require Google Play Services to be installed and enabled on the device.

securityRequireUpToDateSecurityProviderssecurityRequireUpToDateSecurityProviders

BooleanBoolean

要求设备具有最新的安全提供程序。Require the device to have up to date security providers. 设备将要求启用 Google Play Services 并保持最新状态。The device will require Google Play Services to be enabled and up to date.

securityRequireCompanyPortalAppIntegritysecurityRequireCompanyPortalAppIntegrity

BooleanBoolean

要求设备传递公司门户客户端应用运行时完整性检查。Require the device to pass the Company Portal client app runtime integrity check.

响应Response

If successful, this method returns a 200 OK response code and an updated androidWorkProfileCompliancePolicy object in the response body.

示例Example

请求Request

下面是一个请求示例。Here is an example of the request.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}

Content-type: application/json

Content-length: 1170

{

"@odata.type": "#microsoft.graph.androidWorkProfileCompliancePolicy",

"description": "Description value",

"displayName": "Display Name value",

"version": 7,

"passwordRequired": true,

"passwordMinimumLength": 5,

"passwordRequiredType": "alphabetic",

"passwordMinutesOfInactivityBeforeLock": 5,

"passwordExpirationDays": 6,

"passwordPreviousPasswordBlockCount": 2,

"securityPreventInstallAppsFromUnknownSources": true,

"securityDisableUsbDebugging": true,

"securityRequireVerifyApps": true,

"deviceThreatProtectionEnabled": true,

"deviceThreatProtectionRequiredSecurityLevel": "secured",

"securityBlockJailbrokenDevices": true,

"osMinimumVersion": "Os Minimum Version value",

"osMaximumVersion": "Os Maximum Version value",

"minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",

"storageRequireEncryption": true,

"securityRequireSafetyNetAttestationBasicIntegrity": true,

"securityRequireSafetyNetAttestationCertifiedDevice": true,

"securityRequireGooglePlayServices": true,

"securityRequireUpToDateSecurityProviders": true,

"securityRequireCompanyPortalAppIntegrity": true

}

响应Response

下面是一个响应示例。注意：为了简单起见，可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK

Content-Type: application/json

Content-Length: 1342

{

"@odata.type": "#microsoft.graph.androidWorkProfileCompliancePolicy",

"id": "4e385271-5271-4e38-7152-384e7152384e",

"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",

"description": "Description value",

"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",

"displayName": "Display Name value",

"version": 7,

"passwordRequired": true,

"passwordMinimumLength": 5,

"passwordRequiredType": "alphabetic",

"passwordMinutesOfInactivityBeforeLock": 5,

"passwordExpirationDays": 6,

"passwordPreviousPasswordBlockCount": 2,

"securityPreventInstallAppsFromUnknownSources": true,

"securityDisableUsbDebugging": true,

"securityRequireVerifyApps": true,

"deviceThreatProtectionEnabled": true,

"deviceThreatProtectionRequiredSecurityLevel": "secured",

"securityBlockJailbrokenDevices": true,

"osMinimumVersion": "Os Minimum Version value",

"osMaximumVersion": "Os Maximum Version value",

"minAndroidSecurityPatchLevel": "Min Android Security Patch Level value",

"storageRequireEncryption": true,

"securityRequireSafetyNetAttestationBasicIntegrity": true,

"securityRequireSafetyNetAttestationCertifiedDevice": true,

"securityRequireGooglePlayServices": true,

"securityRequireUpToDateSecurityProviders": true,

"securityRequireCompanyPortalAppIntegrity": true

}