命名空间:microsoft.graph
重要: Microsoft Graph 中 /beta 版本下的 API 可能会发生更改,这可能会中断应用程序。 虽然 Microsoft 支持Intune /beta API,但你应自行决定使用这些 API。 通常,建议不要在生产应用程序中使用 /beta API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
注意:适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
用于配置针对特定安全组和 Android 设备上指定的一组应用的详细管理设置的策略
继承自 targetedManagedAppProtection
方法
属性
属性 | 类型 | 说明 |
---|---|---|
id | String | 实体的键。 继承自 managedAppPolicy |
displayName | String | 策略显示名称。 继承自 managedAppPolicy |
description | String | 策略的说明。 继承自 managedAppPolicy |
createdDateTime | DateTimeOffset | 创建策略的日期和时间。 继承自 managedAppPolicy |
lastModifiedDateTime | DateTimeOffset | 上次修改策略的时间。 继承自 managedAppPolicy |
roleScopeTagIds | 字符串集合 | 此实体实例的范围标记列表。 继承自 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 链接。 继承自 managedAppProtection |
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。 可取值为:numeric 、alphanumericAndSymbol 。 |
periodBeforePinReset | Duration | TimePeriod,如果 PinRequired 设置为 True,必须在此之前重置所有级别的 PIN。 继承自 managedAppProtection |
allowedDataStorageLocations | managedAppDataStorageLocation 集合 | 用户可能存储托管数据的数据存储位置。 继承自 managedAppProtection |
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 |
minimumWipeOsVersion | String | 小于或等于指定版本的版本将擦除托管应用和关联的公司数据。 继承自 managedAppProtection |
minimumWipeAppVersion | String | 小于或等于指定版本的版本将擦除托管应用和关联的公司数据。 继承自 managedAppProtection |
appActionIfDeviceComplianceRequired | managedAppRemediationAction | 如果 DeviceComplianceRequired 设置为 true,则定义当设备已获取 root 权限或越狱时,阻止或擦除托管应用的行为。 继承自 managedAppProtection。 可取值为:block 、wipe 、warn 。 |
appActionIfMaximumPinRetriesExceeded | managedAppRemediationAction | 根据错误引脚重试的最大次数定义托管应用行为(阻止或擦除)。 继承自 managedAppProtection。 可取值为:block 、wipe 、warn 。 |
pinRequiredInsteadOfBiometricTimeout | 持续时间 | 应用 PIN 而不是从 managedAppProtection 继承的非生物识别密码的超时(以分钟为单位) |
allowedOutboundClipboardSharingExceptionLength | Int32 | 指定可从组织数据和帐户剪切或复制到任何应用程序的字符数。 此设置覆盖 AllowedOutboundClipboardSharingLevel 限制。 默认值“0”表示不允许出现异常。 继承自 managedAppProtection |
notificationRestriction | managedAppNotificationRestriction | 指定继承自 managedAppProtection 的应用通知限制。 可取值为:allow 、blockOrganizationalData 、block 。 |
isAssigned | Boolean | 指示策略是否部署到任何包含组。 继承自 targetedManagedAppProtection |
targetedAppManagementLevels | appManagementLevel | 此策略的预期应用管理级别继承自 targetedManagedAppProtection。 可能的值是:unspecified 、unmanaged 、mdm 、androidEnterprise 。 |
screenCaptureBlocked | Boolean | 指示托管用户是否可以对托管应用进行屏幕截图 |
disableAppEncryptionIfDeviceEncryptionIsEnabled | Boolean | 启用此设置后,如果启用设备级加密,则应用级加密将被禁用 |
encryptAppData | Boolean | 指示是否应加密托管应用的应用程序数据 |
deployedAppCount | Int32 | 当前策略部署到的应用的计数。 |
minimumRequiredPatchVersion | String | 定义用户可以获得对应用的安全访问权限所需的最早的必需 Android 安全修补程序级别。 |
minimumWarningPatchVersion | String | 定义用户可以获得对应用的安全访问权限所需的最早推荐 Android 安全修补程序级别。 |
exemptedAppPackages | keyValuePair 集合 | 此列表中的应用包将不受策略限制,并且能够接收来自托管应用的数据。 |
minimumWipePatchVersion | String | Android 安全修补程序级别小于或等于指定值将擦除托管应用和关联的公司数据。 |
allowedAndroidDeviceManufacturers | String | 允许以字符串形式为托管应用工作的设备制造商的分号分隔列表。 |
appActionIfAndroidDeviceManufacturerNotAllowed | managedAppRemediationAction | 定义托管应用行为,如果不允许指定的设备制造商,则阻止或擦除。 可取值为:block 、wipe 、warn 。 |
requiredAndroidSafetyNetDeviceAttestationType | androidManagedAppSafetyNetDeviceAttestationType | 定义托管应用正常运行的 Android SafetyNet 设备证明要求。 可取值为:none 、basicIntegrity 、basicIntegrityAndDeviceCertification 。 |
appActionIfAndroidSafetyNetDeviceAttestationFailed | managedAppRemediationAction | 定义托管应用行为(警告或阻止),如果指定的 Android SafetyNet 证明要求失败。 可取值为:block 、wipe 、warn 。 |
requiredAndroidSafetyNetAppsVerificationType | androidManagedAppSafetyNetAppsVerificationType | 定义托管应用正常运行的 Android SafetyNet 应用验证要求。 可取值为:none 、enabled 。 |
appActionIfAndroidSafetyNetAppsVerificationFailed | managedAppRemediationAction | 定义托管应用行为(警告或阻止),如果指定的 Android 应用验证要求失败。 可取值为:block 、wipe 、warn 。 |
customBrowserPackageId | String | 在 Android 上打开 Web 链接的自定义浏览器的唯一标识符。 |
customBrowserDisplayName | String | 在 Android 上打开 Web 链接的首选自定义浏览器的友好名称。 |
minimumRequiredCompanyPortalVersion | String | 设备或应用访问上必须安装的最低公司门户版本将被阻止 |
minimumWarningCompanyPortalVersion | String | 必须在设备上安装的最低公司门户版本,否则用户将收到警告 |
minimumWipeCompanyPortalVersion | String | 必须安装在设备上或应用上的公司数据的最低版本公司门户将被擦除 |
关系
关系 | 类型 | 说明 |
---|---|---|
移动应用管理(MAM) | ||
assignments | targetedManagedAppPolicyAssignment 集合 | 策略部署到的包含组和排除组列表的导航属性。 继承自 targetedManagedAppProtection |
apps | managedMobileApp 集合 | 策略部署到的应用的列表。 |
deploymentSummary | managedAppPolicyDeploymentSummary | 配置的部署摘要的导航属性。 |
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"@odata.type": "#microsoft.graph.androidManagedAppProtection",
"displayName": "String",
"description": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"roleScopeTagIds": [
"String"
],
"id": "String (identifier)",
"version": "String",
"periodOfflineBeforeAccessCheck": "String (duration)",
"periodOnlineBeforeAccessCheck": "String (duration)",
"allowedInboundDataTransferSources": "String",
"allowedOutboundDataTransferDestinations": "String",
"organizationalCredentialsRequired": true,
"allowedOutboundClipboardSharingLevel": "String",
"dataBackupBlocked": true,
"deviceComplianceRequired": true,
"managedBrowserToOpenLinksRequired": true,
"saveAsBlocked": true,
"periodOfflineBeforeWipeIsEnforced": "String (duration)",
"pinRequired": true,
"maximumPinRetries": 1024,
"simplePinBlocked": true,
"minimumPinLength": 1024,
"pinCharacterSet": "String",
"periodBeforePinReset": "String (duration)",
"allowedDataStorageLocations": [
"String"
],
"contactSyncBlocked": true,
"printBlocked": true,
"fingerprintBlocked": true,
"disableAppPinIfDevicePinIsSet": true,
"minimumRequiredOsVersion": "String",
"minimumWarningOsVersion": "String",
"minimumRequiredAppVersion": "String",
"minimumWarningAppVersion": "String",
"minimumWipeOsVersion": "String",
"minimumWipeAppVersion": "String",
"appActionIfDeviceComplianceRequired": "String",
"appActionIfMaximumPinRetriesExceeded": "String",
"pinRequiredInsteadOfBiometricTimeout": "String (duration)",
"allowedOutboundClipboardSharingExceptionLength": 1024,
"notificationRestriction": "String",
"isAssigned": true,
"targetedAppManagementLevels": "String",
"screenCaptureBlocked": true,
"disableAppEncryptionIfDeviceEncryptionIsEnabled": true,
"encryptAppData": true,
"deployedAppCount": 1024,
"minimumRequiredPatchVersion": "String",
"minimumWarningPatchVersion": "String",
"exemptedAppPackages": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "String",
"value": "String"
}
],
"minimumWipePatchVersion": "String",
"allowedAndroidDeviceManufacturers": "String",
"appActionIfAndroidDeviceManufacturerNotAllowed": "String",
"requiredAndroidSafetyNetDeviceAttestationType": "String",
"appActionIfAndroidSafetyNetDeviceAttestationFailed": "String",
"requiredAndroidSafetyNetAppsVerificationType": "String",
"appActionIfAndroidSafetyNetAppsVerificationFailed": "String",
"customBrowserPackageId": "String",
"customBrowserDisplayName": "String",
"minimumRequiredCompanyPortalVersion": "String",
"minimumWarningCompanyPortalVersion": "String",
"minimumWipeCompanyPortalVersion": "String"
}