更新 iosManagedAppProtection
命名空间：microsoft.graph
注意： 适用于 Intune 的 Microsoft Graph API 需要适用于租户的 活动 Intune 许可证。
更新 iosManagedAppProtection 对象的属性。
先决条件
要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。
| 权限类型 | 权限（从最低特权到最高特权） |
|---|---|
| 委派（工作或学校帐户） | DeviceManagementApps.ReadWrite.All |
| 委派（个人 Microsoft 帐户） | 不支持。 |
| 应用程序 | DeviceManagementApps.ReadWrite.All |
HTTP 请求
PATCH /deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId}
请求标头
| 标头 | 值 |
|---|---|
| Authorization | Bearer <token>。必需。 |
| 接受 | application/json |
请求正文
在请求正文中，提供 iosManagedAppProtection 对象的 JSON 表示形式。
下表显示创建 iosManagedAppProtection 时所需的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| displayName | String | 策略显示名称。 继承自 managedAppPolicy |
| 说明 | 字符串 | 策略的说明。 继承自 managedAppPolicy |
| createdDateTime | DateTimeOffset | 创建策略的日期和时间。 继承自 managedAppPolicy |
| lastModifiedDateTime | DateTimeOffset | 上次修改策略的时间。 继承自 managedAppPolicy |
| id | String | 实体的键。 继承自 managedAppPolicy |
| version | String | 实体的版本。 继承自 managedAppPolicy |
| periodOfflineBeforeAccessCheck | Duration | 设备未连接到 Internet 时在该时间段后检查访问权限。 继承自 managedAppProtection |
| periodOnlineBeforeAccessCheck | Duration | 设备连接到 Internet 时在该时间段后检查访问权限。 继承自 managedAppProtection |
| allowedInboundDataTransferSources | managedAppDataTransferLevel | 允许传输其中的数据的源。 继承自 managedAppProtection。 可取值为：allApps、managedApps、none。 |
| allowedOutboundDataTransferDestinations | managedAppDataTransferLevel | 允许向其传输数据的目标。 继承自 managedAppProtection。 可取值为：allApps、managedApps、none。 |
| organizationalCredentialsRequired | Boolean | 指示是否需要组织凭据才能使用应用。 继承自 managedAppProtection |
| allowedOutboundClipboardSharingLevel | managedAppClipboardSharingLevel | 可以在托管设备上的应用之间共享剪贴板的级别。 继承自 managedAppProtection。 可取值为：allApps、managedAppsWithPasteIn、managedApps、blocked。 |
| dataBackupBlocked | Boolean | 指示是否阻止备份托管应用的数据。 继承自 managedAppProtection |
| deviceComplianceRequired | Boolean | 指示是否需要设备符合性。 继承自 managedAppProtection |
| managedBrowserToOpenLinksRequired | Boolean | 指示是应在托管浏览器应用中打开 Internet 链接，还是应在适用于 iOS) 的 CustomBrowserProtocol (或 CustomBrowserPackageId/CustomBrowserDisplayName (中为 Android 指定的任何自定义浏览器) 继承自 managedAppProtection |
| saveAsBlocked | Boolean | 指示用户是否可以使用“另存为”菜单项保存受保护文件的副本。 继承自 managedAppProtection |
| periodOfflineBeforeWipeIsEnforced | Duration | 在擦除所有托管数据之前，允许应用保持从 Internet 断开连接的时间量。 继承自 managedAppProtection |
| pinRequired | Boolean | 指示是否需要应用级 PIN。 继承自 managedAppProtection |
| maximumPinRetries | Int32 | 阻止或擦除托管应用之前，最大错误的引脚重试尝试次数。 继承自 managedAppProtection |
| simplePinBlocked | Boolean | 指示是否阻止 simplePin。 继承自 managedAppProtection |
| minimumPinLength | Int32 | PinRequired 设置为 True 时应用级 PIN 所需的最小 PIN 长度。继承自 managedAppProtection |
| pinCharacterSet | managedAppPinCharacterSet | PinRequired 设置为 True 时可用于应用级 PIN 的字符集。 继承自 managedAppProtection。 可取值为：numeric、alphanumericAndSymbol。 |
| periodBeforePinReset | Duration | TimePeriod，如果 PinRequired 设置为 True，必须在此之前重置所有级别的 PIN。 继承自 managedAppProtection |
| allowedDataStorageLocations | managedAppDataStorageLocation 集合 | 用户可能存储托管数据的数据存储位置。 继承自 managedAppProtection。 可能的值是：oneDriveForBusiness、sharePoint、box、localStorage。 |
| contactSyncBlocked | Boolean | 指示联系人是否可以同步到用户的设备。 继承自 managedAppProtection |
| printBlocked | Boolean | 指示是否允许从托管应用进行打印。 继承自 managedAppProtection |
| fingerprintBlocked | Boolean | 指示如果 PinRequired 设置为 True，是否允许使用指纹读取器代替 PIN。 继承自 managedAppProtection |
| disableAppPinIfDevicePinIsSet | Boolean | 指示如果设置了设备 PIN，是否需要使用应用 PIN。 继承自 managedAppProtection |
| minimumRequiredOsVersion | String | 低于指定版本的版本将阻止托管应用访问公司数据。 继承自 managedAppProtection |
| minimumWarningOsVersion | String | 低于指定版本的版本将导致托管应用访问公司数据时出现警告消息。 继承自 managedAppProtection |
| minimumRequiredAppVersion | String | 低于指定版本的版本将阻止托管应用访问公司数据。 继承自 managedAppProtection |
| minimumWarningAppVersion | String | 低于指定版本的版本将导致托管应用出现警告消息。 继承自 managedAppProtection |
| managedBrowser | managedBrowserType | 指示在哪个托管浏览器 () 应打开 Internet 链接。 配置此属性时，ManagedBrowserToOpenLinksRequired 应为 true。 继承自 managedAppProtection。 可取值为：notConfigured、microsoftEdge。 |
| isAssigned | Boolean | 指示策略是否部署到任何包含组。 继承自 targetedManagedAppProtection |
| appDataEncryptionType | managedAppDataEncryptionType | 应该用于托管应用中的数据的加密类型。 可取值为：useDeviceSettings、afterDeviceRestart、whenDeviceLockedExceptOpenFiles、whenDeviceLocked。 |
| minimumRequiredSdkVersion | String | 低于指定版本的版本将阻止托管应用访问公司数据。 |
| deployedAppCount | Int32 | 当前策略部署到的应用的计数。 |
| faceIdBlocked | Boolean | 指示如果 PinRequired 设置为 True，是否允许使用 FaceID 代替 PIN。 |
| customBrowserProtocol | 字符串 | 用于在 iOS 上打开 Web 链接的自定义浏览器协议。 配置此属性时，ManagedBrowserToOpenLinksRequired 应为 true。 |
响应
如果成功，此方法在响应正文中返回 200 OK 响应代码和更新的 iosManagedAppProtection 对象。
示例
请求
下面是一个请求示例。
PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId}
Content-type: application/json
Content-length: 1667
{
"@odata.type": "#microsoft.graph.iosManagedAppProtection",
"displayName": "Display Name value",
"description": "Description value",
"version": "Version value",
"periodOfflineBeforeAccessCheck": "-PT17.1357909S",
"periodOnlineBeforeAccessCheck": "PT35.0018757S",
"allowedInboundDataTransferSources": "managedApps",
"allowedOutboundDataTransferDestinations": "managedApps",
"organizationalCredentialsRequired": true,
"allowedOutboundClipboardSharingLevel": "managedAppsWithPasteIn",
"dataBackupBlocked": true,
"deviceComplianceRequired": true,
"managedBrowserToOpenLinksRequired": true,
"saveAsBlocked": true,
"periodOfflineBeforeWipeIsEnforced": "-PT3M22.1587532S",
"pinRequired": true,
"maximumPinRetries": 1,
"simplePinBlocked": true,
"minimumPinLength": 0,
"pinCharacterSet": "alphanumericAndSymbol",
"periodBeforePinReset": "PT3M29.6631862S",
"allowedDataStorageLocations": [
"sharePoint"
],
"contactSyncBlocked": true,
"printBlocked": true,
"fingerprintBlocked": true,
"disableAppPinIfDevicePinIsSet": true,
"minimumRequiredOsVersion": "Minimum Required Os Version value",
"minimumWarningOsVersion": "Minimum Warning Os Version value",
"minimumRequiredAppVersion": "Minimum Required App Version value",
"minimumWarningAppVersion": "Minimum Warning App Version value",
"managedBrowser": "microsoftEdge",
"isAssigned": true,
"appDataEncryptionType": "afterDeviceRestart",
"minimumRequiredSdkVersion": "Minimum Required Sdk Version value",
"deployedAppCount": 0,
"faceIdBlocked": true,
"customBrowserProtocol": "Custom Browser Protocol value"
}
响应
下面是一个响应示例。注意：为了简单起见，可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1839
{
"@odata.type": "#microsoft.graph.iosManagedAppProtection",
"displayName": "Display Name value",
"description": "Description value",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"id": "5bc789cb-89cb-5bc7-cb89-c75bcb89c75b",
"version": "Version value",
"periodOfflineBeforeAccessCheck": "-PT17.1357909S",
"periodOnlineBeforeAccessCheck": "PT35.0018757S",
"allowedInboundDataTransferSources": "managedApps",
"allowedOutboundDataTransferDestinations": "managedApps",
"organizationalCredentialsRequired": true,
"allowedOutboundClipboardSharingLevel": "managedAppsWithPasteIn",
"dataBackupBlocked": true,
"deviceComplianceRequired": true,
"managedBrowserToOpenLinksRequired": true,
"saveAsBlocked": true,
"periodOfflineBeforeWipeIsEnforced": "-PT3M22.1587532S",
"pinRequired": true,
"maximumPinRetries": 1,
"simplePinBlocked": true,
"minimumPinLength": 0,
"pinCharacterSet": "alphanumericAndSymbol",
"periodBeforePinReset": "PT3M29.6631862S",
"allowedDataStorageLocations": [
"sharePoint"
],
"contactSyncBlocked": true,
"printBlocked": true,
"fingerprintBlocked": true,
"disableAppPinIfDevicePinIsSet": true,
"minimumRequiredOsVersion": "Minimum Required Os Version value",
"minimumWarningOsVersion": "Minimum Warning Os Version value",
"minimumRequiredAppVersion": "Minimum Required App Version value",
"minimumWarningAppVersion": "Minimum Warning App Version value",
"managedBrowser": "microsoftEdge",
"isAssigned": true,
"appDataEncryptionType": "afterDeviceRestart",
"minimumRequiredSdkVersion": "Minimum Required Sdk Version value",
"deployedAppCount": 0,
"faceIdBlocked": true,
"customBrowserProtocol": "Custom Browser Protocol value"
}
反馈
提交和查看相关反馈