创建 iosManagedAppProtection

命名空间：microsoft.graph

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

创建新的 iosManagedAppProtection 对象。

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

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

权限

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

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

HTTP 请求

POST /deviceAppManagement/iosManagedAppProtections

请求标头

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

请求正文

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

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

属性	类型	说明
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。 可取值为：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	布尔值	指示是应在托管浏览器应用中打开 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。 可取值为：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	String	用于在 iOS 上打开 Weblink 的自定义浏览器协议。 配置此属性后，ManagedBrowserToOpenLinksRequired 应为 true。

响应

如果成功，此方法在响应正文中返回 201 Created 响应代码和 iosManagedAppProtection 对象。

示例

请求

下面是一个请求示例。

HTTP

POST https://graph.microsoft.com/v1.0/deviceAppManagement/iosManagedAppProtections
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"
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new IosManagedAppProtection
{
	OdataType = "#microsoft.graph.iosManagedAppProtection",
	DisplayName = "Display Name value",
	Description = "Description value",
	Version = "Version value",
	PeriodOfflineBeforeAccessCheck = TimeSpan.Parse("-PT17.1357909S"),
	PeriodOnlineBeforeAccessCheck = TimeSpan.Parse("PT35.0018757S"),
	AllowedInboundDataTransferSources = ManagedAppDataTransferLevel.ManagedApps,
	AllowedOutboundDataTransferDestinations = ManagedAppDataTransferLevel.ManagedApps,
	OrganizationalCredentialsRequired = true,
	AllowedOutboundClipboardSharingLevel = ManagedAppClipboardSharingLevel.ManagedAppsWithPasteIn,
	DataBackupBlocked = true,
	DeviceComplianceRequired = true,
	ManagedBrowserToOpenLinksRequired = true,
	SaveAsBlocked = true,
	PeriodOfflineBeforeWipeIsEnforced = TimeSpan.Parse("-PT3M22.1587532S"),
	PinRequired = true,
	MaximumPinRetries = 1,
	SimplePinBlocked = true,
	MinimumPinLength = 0,
	PinCharacterSet = ManagedAppPinCharacterSet.AlphanumericAndSymbol,
	PeriodBeforePinReset = TimeSpan.Parse("PT3M29.6631862S"),
	AllowedDataStorageLocations = new List<ManagedAppDataStorageLocation?>
	{
		ManagedAppDataStorageLocation.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 = ManagedBrowserType.MicrosoftEdge,
	IsAssigned = true,
	AppDataEncryptionType = ManagedAppDataEncryptionType.AfterDeviceRestart,
	MinimumRequiredSdkVersion = "Minimum Required Sdk Version value",
	DeployedAppCount = 0,
	FaceIdBlocked = true,
	CustomBrowserProtocol = "Custom Browser Protocol value",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceAppManagement.IosManagedAppProtections.PostAsync(requestBody);

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

CLI

mgc device-app-management ios-managed-app-protections create --body '{\
  "@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"\
}\
'

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

Go

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  abstractions "github.com/microsoft/kiota-abstractions-go"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewIosManagedAppProtection()
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName) 
description := "Description value"
requestBody.SetDescription(&description) 
version := "Version value"
requestBody.SetVersion(&version) 
periodOfflineBeforeAccessCheck , err := abstractions.ParseISODuration("-PT17.1357909S")
requestBody.SetPeriodOfflineBeforeAccessCheck(&periodOfflineBeforeAccessCheck) 
periodOnlineBeforeAccessCheck , err := abstractions.ParseISODuration("PT35.0018757S")
requestBody.SetPeriodOnlineBeforeAccessCheck(&periodOnlineBeforeAccessCheck) 
allowedInboundDataTransferSources := graphmodels.MANAGEDAPPS_MANAGEDAPPDATATRANSFERLEVEL 
requestBody.SetAllowedInboundDataTransferSources(&allowedInboundDataTransferSources) 
allowedOutboundDataTransferDestinations := graphmodels.MANAGEDAPPS_MANAGEDAPPDATATRANSFERLEVEL 
requestBody.SetAllowedOutboundDataTransferDestinations(&allowedOutboundDataTransferDestinations) 
organizationalCredentialsRequired := true
requestBody.SetOrganizationalCredentialsRequired(&organizationalCredentialsRequired) 
allowedOutboundClipboardSharingLevel := graphmodels.MANAGEDAPPSWITHPASTEIN_MANAGEDAPPCLIPBOARDSHARINGLEVEL 
requestBody.SetAllowedOutboundClipboardSharingLevel(&allowedOutboundClipboardSharingLevel) 
dataBackupBlocked := true
requestBody.SetDataBackupBlocked(&dataBackupBlocked) 
deviceComplianceRequired := true
requestBody.SetDeviceComplianceRequired(&deviceComplianceRequired) 
managedBrowserToOpenLinksRequired := true
requestBody.SetManagedBrowserToOpenLinksRequired(&managedBrowserToOpenLinksRequired) 
saveAsBlocked := true
requestBody.SetSaveAsBlocked(&saveAsBlocked) 
periodOfflineBeforeWipeIsEnforced , err := abstractions.ParseISODuration("-PT3M22.1587532S")
requestBody.SetPeriodOfflineBeforeWipeIsEnforced(&periodOfflineBeforeWipeIsEnforced) 
pinRequired := true
requestBody.SetPinRequired(&pinRequired) 
maximumPinRetries := int32(1)
requestBody.SetMaximumPinRetries(&maximumPinRetries) 
simplePinBlocked := true
requestBody.SetSimplePinBlocked(&simplePinBlocked) 
minimumPinLength := int32(0)
requestBody.SetMinimumPinLength(&minimumPinLength) 
pinCharacterSet := graphmodels.ALPHANUMERICANDSYMBOL_MANAGEDAPPPINCHARACTERSET 
requestBody.SetPinCharacterSet(&pinCharacterSet) 
periodBeforePinReset , err := abstractions.ParseISODuration("PT3M29.6631862S")
requestBody.SetPeriodBeforePinReset(&periodBeforePinReset) 
allowedDataStorageLocations := []graphmodels.ManagedAppDataStorageLocationable {
	managedAppDataStorageLocation := graphmodels.SHAREPOINT_MANAGEDAPPDATASTORAGELOCATION 
	requestBody.SetManagedAppDataStorageLocation(&managedAppDataStorageLocation)
}
requestBody.SetAllowedDataStorageLocations(allowedDataStorageLocations)
contactSyncBlocked := true
requestBody.SetContactSyncBlocked(&contactSyncBlocked) 
printBlocked := true
requestBody.SetPrintBlocked(&printBlocked) 
fingerprintBlocked := true
requestBody.SetFingerprintBlocked(&fingerprintBlocked) 
disableAppPinIfDevicePinIsSet := true
requestBody.SetDisableAppPinIfDevicePinIsSet(&disableAppPinIfDevicePinIsSet) 
minimumRequiredOsVersion := "Minimum Required Os Version value"
requestBody.SetMinimumRequiredOsVersion(&minimumRequiredOsVersion) 
minimumWarningOsVersion := "Minimum Warning Os Version value"
requestBody.SetMinimumWarningOsVersion(&minimumWarningOsVersion) 
minimumRequiredAppVersion := "Minimum Required App Version value"
requestBody.SetMinimumRequiredAppVersion(&minimumRequiredAppVersion) 
minimumWarningAppVersion := "Minimum Warning App Version value"
requestBody.SetMinimumWarningAppVersion(&minimumWarningAppVersion) 
managedBrowser := graphmodels.MICROSOFTEDGE_MANAGEDBROWSERTYPE 
requestBody.SetManagedBrowser(&managedBrowser) 
isAssigned := true
requestBody.SetIsAssigned(&isAssigned) 
appDataEncryptionType := graphmodels.AFTERDEVICERESTART_MANAGEDAPPDATAENCRYPTIONTYPE 
requestBody.SetAppDataEncryptionType(&appDataEncryptionType) 
minimumRequiredSdkVersion := "Minimum Required Sdk Version value"
requestBody.SetMinimumRequiredSdkVersion(&minimumRequiredSdkVersion) 
deployedAppCount := int32(0)
requestBody.SetDeployedAppCount(&deployedAppCount) 
faceIdBlocked := true
requestBody.SetFaceIdBlocked(&faceIdBlocked) 
customBrowserProtocol := "Custom Browser Protocol value"
requestBody.SetCustomBrowserProtocol(&customBrowserProtocol) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
iosManagedAppProtections, err := graphClient.DeviceAppManagement().IosManagedAppProtections().Post(context.Background(), requestBody, nil)

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

IosManagedAppProtection iosManagedAppProtection = new IosManagedAppProtection();
iosManagedAppProtection.setOdataType("#microsoft.graph.iosManagedAppProtection");
iosManagedAppProtection.setDisplayName("Display Name value");
iosManagedAppProtection.setDescription("Description value");
iosManagedAppProtection.setVersion("Version value");
PeriodAndDuration periodOfflineBeforeAccessCheck = PeriodAndDuration.ofDuration(Duration.parse("-PT17.1357909S"));
iosManagedAppProtection.setPeriodOfflineBeforeAccessCheck(periodOfflineBeforeAccessCheck);
PeriodAndDuration periodOnlineBeforeAccessCheck = PeriodAndDuration.ofDuration(Duration.parse("PT35.0018757S"));
iosManagedAppProtection.setPeriodOnlineBeforeAccessCheck(periodOnlineBeforeAccessCheck);
iosManagedAppProtection.setAllowedInboundDataTransferSources(ManagedAppDataTransferLevel.ManagedApps);
iosManagedAppProtection.setAllowedOutboundDataTransferDestinations(ManagedAppDataTransferLevel.ManagedApps);
iosManagedAppProtection.setOrganizationalCredentialsRequired(true);
iosManagedAppProtection.setAllowedOutboundClipboardSharingLevel(ManagedAppClipboardSharingLevel.ManagedAppsWithPasteIn);
iosManagedAppProtection.setDataBackupBlocked(true);
iosManagedAppProtection.setDeviceComplianceRequired(true);
iosManagedAppProtection.setManagedBrowserToOpenLinksRequired(true);
iosManagedAppProtection.setSaveAsBlocked(true);
PeriodAndDuration periodOfflineBeforeWipeIsEnforced = PeriodAndDuration.ofDuration(Duration.parse("-PT3M22.1587532S"));
iosManagedAppProtection.setPeriodOfflineBeforeWipeIsEnforced(periodOfflineBeforeWipeIsEnforced);
iosManagedAppProtection.setPinRequired(true);
iosManagedAppProtection.setMaximumPinRetries(1);
iosManagedAppProtection.setSimplePinBlocked(true);
iosManagedAppProtection.setMinimumPinLength(0);
iosManagedAppProtection.setPinCharacterSet(ManagedAppPinCharacterSet.AlphanumericAndSymbol);
PeriodAndDuration periodBeforePinReset = PeriodAndDuration.ofDuration(Duration.parse("PT3M29.6631862S"));
iosManagedAppProtection.setPeriodBeforePinReset(periodBeforePinReset);
LinkedList<ManagedAppDataStorageLocation> allowedDataStorageLocations = new LinkedList<ManagedAppDataStorageLocation>();
allowedDataStorageLocations.add(ManagedAppDataStorageLocation.SharePoint);
iosManagedAppProtection.setAllowedDataStorageLocations(allowedDataStorageLocations);
iosManagedAppProtection.setContactSyncBlocked(true);
iosManagedAppProtection.setPrintBlocked(true);
iosManagedAppProtection.setFingerprintBlocked(true);
iosManagedAppProtection.setDisableAppPinIfDevicePinIsSet(true);
iosManagedAppProtection.setMinimumRequiredOsVersion("Minimum Required Os Version value");
iosManagedAppProtection.setMinimumWarningOsVersion("Minimum Warning Os Version value");
iosManagedAppProtection.setMinimumRequiredAppVersion("Minimum Required App Version value");
iosManagedAppProtection.setMinimumWarningAppVersion("Minimum Warning App Version value");
iosManagedAppProtection.setManagedBrowser(EnumSet.of(ManagedBrowserType.MicrosoftEdge));
iosManagedAppProtection.setIsAssigned(true);
iosManagedAppProtection.setAppDataEncryptionType(ManagedAppDataEncryptionType.AfterDeviceRestart);
iosManagedAppProtection.setMinimumRequiredSdkVersion("Minimum Required Sdk Version value");
iosManagedAppProtection.setDeployedAppCount(0);
iosManagedAppProtection.setFaceIdBlocked(true);
iosManagedAppProtection.setCustomBrowserProtocol("Custom Browser Protocol value");
IosManagedAppProtection result = graphClient.deviceAppManagement().iosManagedAppProtections().post(iosManagedAppProtection);

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const iosManagedAppProtection = {
  '@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'
};

await client.api('/deviceAppManagement/iosManagedAppProtections')
	.post(iosManagedAppProtection);

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\IosManagedAppProtection;
use Microsoft\Graph\Generated\Models\ManagedAppDataTransferLevel;
use Microsoft\Graph\Generated\Models\ManagedAppClipboardSharingLevel;
use Microsoft\Graph\Generated\Models\ManagedAppPinCharacterSet;
use Microsoft\Graph\Generated\Models\ManagedAppDataStorageLocation;
use Microsoft\Graph\Generated\Models\ManagedBrowserType;
use Microsoft\Graph\Generated\Models\ManagedAppDataEncryptionType;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new IosManagedAppProtection();
$requestBody->setOdataType('#microsoft.graph.iosManagedAppProtection');
$requestBody->setDisplayName('Display Name value');
$requestBody->setDescription('Description value');
$requestBody->setVersion('Version value');
$requestBody->setPeriodOfflineBeforeAccessCheck(new \DateInterval('-PT17.1357909S'));
$requestBody->setPeriodOnlineBeforeAccessCheck(new \DateInterval('PT35.0018757S'));
$requestBody->setAllowedInboundDataTransferSources(new ManagedAppDataTransferLevel('managedApps'));
$requestBody->setAllowedOutboundDataTransferDestinations(new ManagedAppDataTransferLevel('managedApps'));
$requestBody->setOrganizationalCredentialsRequired(true);
$requestBody->setAllowedOutboundClipboardSharingLevel(new ManagedAppClipboardSharingLevel('managedAppsWithPasteIn'));
$requestBody->setDataBackupBlocked(true);
$requestBody->setDeviceComplianceRequired(true);
$requestBody->setManagedBrowserToOpenLinksRequired(true);
$requestBody->setSaveAsBlocked(true);
$requestBody->setPeriodOfflineBeforeWipeIsEnforced(new \DateInterval('-PT3M22.1587532S'));
$requestBody->setPinRequired(true);
$requestBody->setMaximumPinRetries(1);
$requestBody->setSimplePinBlocked(true);
$requestBody->setMinimumPinLength(0);
$requestBody->setPinCharacterSet(new ManagedAppPinCharacterSet('alphanumericAndSymbol'));
$requestBody->setPeriodBeforePinReset(new \DateInterval('PT3M29.6631862S'));
$requestBody->setAllowedDataStorageLocations([new ManagedAppDataStorageLocation('sharePoint'),	]);
$requestBody->setContactSyncBlocked(true);
$requestBody->setPrintBlocked(true);
$requestBody->setFingerprintBlocked(true);
$requestBody->setDisableAppPinIfDevicePinIsSet(true);
$requestBody->setMinimumRequiredOsVersion('Minimum Required Os Version value');
$requestBody->setMinimumWarningOsVersion('Minimum Warning Os Version value');
$requestBody->setMinimumRequiredAppVersion('Minimum Required App Version value');
$requestBody->setMinimumWarningAppVersion('Minimum Warning App Version value');
$requestBody->setManagedBrowser(new ManagedBrowserType('microsoftEdge'));
$requestBody->setIsAssigned(true);
$requestBody->setAppDataEncryptionType(new ManagedAppDataEncryptionType('afterDeviceRestart'));
$requestBody->setMinimumRequiredSdkVersion('Minimum Required Sdk Version value');
$requestBody->setDeployedAppCount(0);
$requestBody->setFaceIdBlocked(true);
$requestBody->setCustomBrowserProtocol('Custom Browser Protocol value');

$result = $graphServiceClient->deviceAppManagement()->iosManagedAppProtections()->post($requestBody)->wait();

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

PowerShell

Import-Module Microsoft.Graph.Devices.CorporateManagement

$params = @{
	"@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"
}

New-MgDeviceAppManagementiOSManagedAppProtection -BodyParameter $params

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.ios_managed_app_protection import IosManagedAppProtection
from msgraph.generated.models.managed_app_data_transfer_level import ManagedAppDataTransferLevel
from msgraph.generated.models.managed_app_clipboard_sharing_level import ManagedAppClipboardSharingLevel
from msgraph.generated.models.managed_app_pin_character_set import ManagedAppPinCharacterSet
from msgraph.generated.models.managed_app_data_storage_location import ManagedAppDataStorageLocation
from msgraph.generated.models.managed_browser_type import ManagedBrowserType
from msgraph.generated.models.managed_app_data_encryption_type import ManagedAppDataEncryptionType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = IosManagedAppProtection(
	odata_type = "#microsoft.graph.iosManagedAppProtection",
	display_name = "Display Name value",
	description = "Description value",
	version = "Version value",
	period_offline_before_access_check = "-PT17.1357909S",
	period_online_before_access_check = "PT35.0018757S",
	allowed_inbound_data_transfer_sources = ManagedAppDataTransferLevel.ManagedApps,
	allowed_outbound_data_transfer_destinations = ManagedAppDataTransferLevel.ManagedApps,
	organizational_credentials_required = True,
	allowed_outbound_clipboard_sharing_level = ManagedAppClipboardSharingLevel.ManagedAppsWithPasteIn,
	data_backup_blocked = True,
	device_compliance_required = True,
	managed_browser_to_open_links_required = True,
	save_as_blocked = True,
	period_offline_before_wipe_is_enforced = "-PT3M22.1587532S",
	pin_required = True,
	maximum_pin_retries = 1,
	simple_pin_blocked = True,
	minimum_pin_length = 0,
	pin_character_set = ManagedAppPinCharacterSet.AlphanumericAndSymbol,
	period_before_pin_reset = "PT3M29.6631862S",
	allowed_data_storage_locations = [
		ManagedAppDataStorageLocation.SharePoint,
	],
	contact_sync_blocked = True,
	print_blocked = True,
	fingerprint_blocked = True,
	disable_app_pin_if_device_pin_is_set = True,
	minimum_required_os_version = "Minimum Required Os Version value",
	minimum_warning_os_version = "Minimum Warning Os Version value",
	minimum_required_app_version = "Minimum Required App Version value",
	minimum_warning_app_version = "Minimum Warning App Version value",
	managed_browser = ManagedBrowserType.MicrosoftEdge,
	is_assigned = True,
	app_data_encryption_type = ManagedAppDataEncryptionType.AfterDeviceRestart,
	minimum_required_sdk_version = "Minimum Required Sdk Version value",
	deployed_app_count = 0,
	face_id_blocked = True,
	custom_browser_protocol = "Custom Browser Protocol value",
)

result = await graph_client.device_app_management.ios_managed_app_protections.post(request_body)

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

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

HTTP/1.1 201 Created
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"
}