更新 defaultManagedAppProtection

命名空间:microsoft.graph

注意:适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证

更新 defaultManagedAppProtection 对象的属性。

此 API 可用于以下国家级云部署

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国

权限

要调用此 API,需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) DeviceManagementApps.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。
应用程序 DeviceManagementApps.ReadWrite.All

HTTP 请求

PATCH /deviceAppManagement/defaultManagedAppProtections/{defaultManagedAppProtectionId}

请求标头

标头
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权
接受 application/json

请求正文

在请求正文中,提供 defaultManagedAppProtection 对象的 JSON 表示形式。

下表显示创建 defaultManagedAppProtection 时所需的属性。

属性 类型 说明
displayName String 策略显示名称。 继承自 managedAppPolicy
description String 策略的说明。 继承自 managedAppPolicy
createdDateTime DateTimeOffset 创建策略的日期和时间。 继承自 managedAppPolicy
lastModifiedDateTime DateTimeOffset 上次修改策略的时间。 继承自 managedAppPolicy
id String 实体的键。 继承自 managedAppPolicy
version String 实体的版本。 继承自 managedAppPolicy
periodOfflineBeforeAccessCheck Duration 设备未连接到 Internet 时在该时间段后检查访问权限。 继承自 managedAppProtection
periodOnlineBeforeAccessCheck Duration 设备连接到 Internet 时在该时间段后检查访问权限。 继承自 managedAppProtection
allowedInboundDataTransferSources managedAppDataTransferLevel 允许传输其中的数据的源。 继承自 managedAppProtection。 可取值为:allAppsmanagedAppsnone
allowedOutboundDataTransferDestinations managedAppDataTransferLevel 允许向其传输数据的目标。 继承自 managedAppProtection。 可取值为:allAppsmanagedAppsnone
organizationalCredentialsRequired Boolean 指示是否需要组织凭据才能使用应用。 继承自 managedAppProtection
allowedOutboundClipboardSharingLevel managedAppClipboardSharingLevel 可以在托管设备上的应用之间共享剪贴板的级别。 继承自 managedAppProtection。 可能的值是:allAppsmanagedAppsWithPasteInmanagedAppsblocked
dataBackupBlocked Boolean 指示是否阻止备份托管应用的数据。 继承自 managedAppProtection
deviceComplianceRequired Boolean 指示是否需要设备符合性。 继承自 managedAppProtection
managedBrowserToOpenLinksRequired 布尔值 指示是应在托管浏览器应用中打开 Internet 链接,还是应在 iOS) 或 CustomBrowserPackageId/CustomBrowserDisplayName (中打开,) 从 managedAppProtection 继承的 CustomBrowserProtocol (指定的任何自定义浏览器
saveAsBlocked Boolean 指示用户是否可以使用“另存为”菜单项保存受保护文件的副本。 继承自 managedAppProtection
periodOfflineBeforeWipeIsEnforced Duration 在擦除所有托管数据之前,允许应用保持从 Internet 断开连接的时间量。 继承自 managedAppProtection
pinRequired Boolean 指示是否需要应用级 PIN。 继承自 managedAppProtection
maximumPinRetries Int32 在阻止或擦除托管应用之前,错误 PIN 重试尝试的最大次数。 继承自 managedAppProtection
simplePinBlocked Boolean 指示是否阻止 simplePin。 继承自 managedAppProtection
minimumPinLength Int32 PinRequired 设置为 True 时应用级 PIN 所需的最小 PIN 长度。继承自 managedAppProtection
pinCharacterSet managedAppPinCharacterSet PinRequired 设置为 True 时可用于应用级 PIN 的字符集。 继承自 managedAppProtection。 可取值为:numericalphanumericAndSymbol
periodBeforePinReset Duration TimePeriod,如果 PinRequired 设置为 True,必须在此之前重置所有级别的 PIN。 继承自 managedAppProtection
allowedDataStorageLocations managedAppDataStorageLocation 集合 用户可能存储托管数据的数据存储位置。 继承自 managedAppProtection。 可能的值是:oneDriveForBusinesssharePointboxlocalStorage
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。 可取值为:notConfiguredmicrosoftEdge
appDataEncryptionType managedAppDataEncryptionType 应该用于托管应用中的数据的加密类型。 (仅限 iOS) 。 可能的值是:useDeviceSettingsafterDeviceRestartwhenDeviceLockedExceptOpenFileswhenDeviceLocked
screenCaptureBlocked Boolean 指示是否阻止捕获屏幕。 (仅限 Android)
encryptAppData Boolean 指示是否应加密托管应用数据。 (仅限 Android)
disableAppEncryptionIfDeviceEncryptionIsEnabled 布尔值 启用此设置后,如果启用了设备级加密,则会禁用应用级加密。 (仅限 Android)
minimumRequiredSdkVersion String 低于指定版本的版本将阻止托管应用访问公司数据。 仅 (iOS)
customSettings keyValuePair 集合 要发送给受影响用户的一组字符串键和字符串值对,不被此服务改变
deployedAppCount Int32 当前策略部署到的应用的计数。
minimumRequiredPatchVersion String 定义用户可以获得对应用的安全访问权限所需的最早的必需 Android 安全修补程序级别。 (仅限 Android)
minimumWarningPatchVersion String 定义用户可以获得对应用的安全访问权限所需的最早推荐 Android 安全修补程序级别。 (仅限 Android)
faceIdBlocked Boolean 指示如果 PinRequired 设置为 True,是否允许使用 FaceID 代替 PIN。 仅 (iOS)

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和更新的 defaultManagedAppProtection 对象。

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/defaultManagedAppProtections/{defaultManagedAppProtectionId}
Content-type: application/json
Content-length: 2009

{
  "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
  "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",
  "appDataEncryptionType": "afterDeviceRestart",
  "screenCaptureBlocked": true,
  "encryptAppData": true,
  "disableAppEncryptionIfDeviceEncryptionIsEnabled": true,
  "minimumRequiredSdkVersion": "Minimum Required Sdk Version value",
  "customSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ],
  "deployedAppCount": 0,
  "minimumRequiredPatchVersion": "Minimum Required Patch Version value",
  "minimumWarningPatchVersion": "Minimum Warning Patch Version value",
  "faceIdBlocked": true
}

响应

下面是一个响应示例。 注意:为简洁起见,可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。

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

{
  "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
  "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": "77064c51-4c51-7706-514c-0677514c0677",
  "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",
  "appDataEncryptionType": "afterDeviceRestart",
  "screenCaptureBlocked": true,
  "encryptAppData": true,
  "disableAppEncryptionIfDeviceEncryptionIsEnabled": true,
  "minimumRequiredSdkVersion": "Minimum Required Sdk Version value",
  "customSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ],
  "deployedAppCount": 0,
  "minimumRequiredPatchVersion": "Minimum Required Patch Version value",
  "minimumWarningPatchVersion": "Minimum Warning Patch Version value",
  "faceIdBlocked": true
}