创建 depIOSEnrollmentProfileCreate depIOSEnrollmentProfile

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

重要说明: /Beta 版本下的 Microsoft Graph Api 可能会发生更改;不支持生产使用。Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

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

创建新的 depIOSEnrollmentProfile 对象。Create a new depIOSEnrollmentProfile object.

先决条件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) DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All
委派(个人 Microsoft 帐户)Delegated (personal Microsoft account) 不支持。Not supported.
应用程序Application DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All

HTTP 请求HTTP Request

POST /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles

请求标头Request headers

标头Header Value
AuthorizationAuthorization Bearer <token>。必需。Bearer <token> Required.
接受Accept application/jsonapplication/json

请求正文Request body

在请求正文中,提供 depIOSEnrollmentProfile 对象的 JSON 表示形式。In the request body, supply a JSON representation for the depIOSEnrollmentProfile object.

下表显示创建 depIOSEnrollmentProfile 时所需的属性。The following table shows the properties that are required when you create the depIOSEnrollmentProfile.

属性Property 类型Type 说明Description
idid 字符串String 继承自enrollmentProfile的对象的 GUIDThe GUID for the object Inherited from enrollmentProfile
displayNamedisplayName 字符串String 继承自enrollmentProfile的配置文件的名称Name of the profile Inherited from enrollmentProfile
说明description 字符串String EnrollmentProfile继承的配置文件的说明Description of the profile Inherited from enrollmentProfile
requiresUserAuthenticationrequiresUserAuthentication 布尔Boolean 指示配置文件是否需要从EnrollmentProfile继承的用户身份验证Indicates if the profile requires user authentication Inherited from enrollmentProfile
configurationEndpointUrlconfigurationEndpointUrl 字符串String 用于从EnrollmentProfile继承的注册的配置终结点 urlConfiguration endpoint url to use for Enrollment Inherited from enrollmentProfile
enableAuthenticationViaCompanyPortalenableAuthenticationViaCompanyPortal 布尔Boolean 指示使用 Apple Setup 助理(而不是公司门户)进行身份验证。Indicates to authenticate with Apple Setup Assistant instead of Company Portal. 继承自 enrollmentProfileInherited from enrollmentProfile
requireCompanyPortalOnSetupAssistantEnrolledDevicesrequireCompanyPortalOnSetupAssistantEnrolledDevices 布尔Boolean 指示在从EnrollmentProfile继承的安装助理注册设备上需要公司门户Indicates that Company Portal is required on setup assistant enrolled devices Inherited from enrollmentProfile
isDefaultisDefault BooleanBoolean 指示这是否是从DepEnrollmentBaseProfile继承的默认配置文件Indicates if this is the default profile Inherited from depEnrollmentBaseProfile
supervisedModeEnabledsupervisedModeEnabled 布尔Boolean 监督模式,如果启用,则为 True,否则为 false。Supervised mode, True to enable, false otherwise. https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune有关详细信息,请参阅。See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. 继承自 depEnrollmentBaseProfileInherited from depEnrollmentBaseProfile
supportDepartmentsupportDepartment 字符串String 支持从DepEnrollmentBaseProfile继承部门信息Support department information Inherited from depEnrollmentBaseProfile
passCodeDisabledpassCodeDisabled 布尔Boolean 指示是否禁用了从DepEnrollmentBaseProfile继承的密码设置窗格Indicates if Passcode setup pane is disabled Inherited from depEnrollmentBaseProfile
isMandatoryisMandatory 布尔Boolean 指示是否必须从DepEnrollmentBaseProfile继承配置文件Indicates if the profile is mandatory Inherited from depEnrollmentBaseProfile
locationDisabledlocationDisabled 布尔Boolean 指示是否禁用从DepEnrollmentBaseProfile继承位置服务设置窗格Indicates if Location service setup pane is disabled Inherited from depEnrollmentBaseProfile
supportPhoneNumbersupportPhoneNumber 字符串String 支持从DepEnrollmentBaseProfile继承的电话号码Support phone number Inherited from depEnrollmentBaseProfile
profileRemovalDisabledprofileRemovalDisabled 布尔Boolean 指示是否禁用了从DepEnrollmentBaseProfile继承的配置文件删除选项Indicates if the profile removal option is disabled Inherited from depEnrollmentBaseProfile
restoreBlockedrestoreBlocked 布尔Boolean 指示是否阻止从DepEnrollmentBaseProfile继承的还原设置窗格Indicates if Restore setup pane is blocked Inherited from depEnrollmentBaseProfile
appleIdDisabledappleIdDisabled 布尔Boolean 指示是否禁用了 Apple id 设置窗格从DepEnrollmentBaseProfile继承Indicates if Apple id setup pane is disabled Inherited from depEnrollmentBaseProfile
termsAndConditionsDisabledtermsAndConditionsDisabled 布尔Boolean 指示是否已禁用 "条款和条件" 安装窗格从DepEnrollmentBaseProfile继承Indicates if 'Terms and Conditions' setup pane is disabled Inherited from depEnrollmentBaseProfile
touchIdDisabledtouchIdDisabled 布尔Boolean 指示是否禁用了触控 id 设置窗格从DepEnrollmentBaseProfile继承Indicates if touch id setup pane is disabled Inherited from depEnrollmentBaseProfile
applePayDisabledapplePayDisabled 布尔Boolean 指示是否禁用了 Apple 付费设置窗格从DepEnrollmentBaseProfile继承Indicates if Apple pay setup pane is disabled Inherited from depEnrollmentBaseProfile
zoomDisabledzoomDisabled 布尔Boolean 指示是否禁用了缩放设置窗格从DepEnrollmentBaseProfile继承Indicates if zoom setup pane is disabled Inherited from depEnrollmentBaseProfile
siriDisabledsiriDisabled 布尔Boolean 指示是否禁用了从DepEnrollmentBaseProfile继承的 siri 安装窗格Indicates if siri setup pane is disabled Inherited from depEnrollmentBaseProfile
diagnosticsDisableddiagnosticsDisabled 布尔Boolean 指示是否禁用了从DepEnrollmentBaseProfile继承的诊断设置窗格Indicates if diagnostics setup pane is disabled Inherited from depEnrollmentBaseProfile
displayToneSetupDisableddisplayToneSetupDisabled 布尔Boolean 指示是否禁用了从DepEnrollmentBaseProfile继承的 displaytone 安装程序屏幕Indicates if displaytone setup screen is disabled Inherited from depEnrollmentBaseProfile
privacyPaneDisabledprivacyPaneDisabled 布尔Boolean 指示是否禁用了从DepEnrollmentBaseProfile继承的隐私屏幕Indicates if privacy screen is disabled Inherited from depEnrollmentBaseProfile
screenTimeScreenDisabledscreenTimeScreenDisabled 布尔Boolean 指示是否禁用了从DepEnrollmentBaseProfile继承的屏幕超时设置Indicates if screen timeout setup is disabled Inherited from depEnrollmentBaseProfile
deviceNameTemplatedeviceNameTemplate 字符串String 设置文本或名称模式。Sets a literal or name pattern. 继承自 depEnrollmentBaseProfileInherited from depEnrollmentBaseProfile
configurationWebUrlconfigurationWebUrl 布尔Boolean DepEnrollmentBaseProfile继承的设置助理登录 URLURL for setup assistant login Inherited from depEnrollmentBaseProfile
iTunesPairingModeiTunesPairingMode iTunesPairingModeiTunesPairingMode 指示 iTunes 配对模式。Indicates the iTunes pairing mode. 可取值为:disallowallowrequiresCertificatePossible values are: disallow, allow, requiresCertificate.
managementCertificatesmanagementCertificates managementCertificateWithThumbprint 集合managementCertificateWithThumbprint collection Apple 配置器的管理证书Management certificates for Apple Configurator
restoreFromAndroidDisabledrestoreFromAndroidDisabled 布尔Boolean 指示是否禁用从 Android 还原Indicates if Restore from Android is disabled
awaitDeviceConfiguredConfirmationawaitDeviceConfiguredConfirmation 布尔Boolean 指示设备是否需要等待已配置的确认Indicates if the device will need to wait for configured confirmation
sharedIPadMaximumUserCountsharedIPadMaximumUserCount Int32Int32 这指定了可以使用共享 iPad 的最大用户数。This specifies the maximum number of users that can use a shared iPad. 仅适用于共享 iPad 模式。Only applicable in shared iPad mode.
enableSharedIPadenableSharedIPad 布尔Boolean 这表示设备是否要在启用多用户方案的模式中进行注册。This indicates whether the device is to be enrolled in a mode which enables multi user scenarios. 仅适用于共享 Ipad。Only applicable in shared iPads.
companyPortalVppTokenIdcompanyPortalVppTokenId 字符串String 如果设置,则指示应使用哪种 Vpp 令牌来部署带设备许可的公司门户。If set, indicates which Vpp token should be used to deploy the Company Portal w/ device licensing. 若要设置此属性,必须设置 "enableAuthenticationViaCompanyPortal"。'enableAuthenticationViaCompanyPortal' must be set in order for this property to be set.
enableSingleAppEnrollmentModeenableSingleAppEnrollmentMode 布尔Boolean 通知设备启用单应用模式,并在注册过程中应用应用锁定。Tells the device to enable single app mode and apply app-lock during enrollment. 默认为 false。Default is false. 若要设置此属性,必须设置 "enableAuthenticationViaCompanyPortal" 和 "companyPortalVppTokenId"。'enableAuthenticationViaCompanyPortal' and 'companyPortalVppTokenId' must be set for this property to be set.
homeButtonScreenDisabledhomeButtonScreenDisabled 布尔Boolean 指示是否禁用 "主页按钮灵敏度" 屏幕Indicates if home button sensitivity screen is disabled
iMessageAndFaceTimeScreenDisablediMessageAndFaceTimeScreenDisabled 布尔Boolean 指示是否禁用 iMessage 和 FaceTime 屏幕Indicates if iMessage and FaceTime screen is disabled
onBoardingScreenDisabledonBoardingScreenDisabled 布尔Boolean 指示是否已禁用载入安装程序屏幕Indicates if onboarding setup screen is disabled
simSetupScreenDisabledsimSetupScreenDisabled 布尔Boolean 指示是否禁用了 SIMSetup 屏幕Indicates if the SIMSetup screen is disabled
softwareUpdateScreenDisabledsoftwareUpdateScreenDisabled 布尔Boolean 指示是否禁用强制 sofware 更新屏幕Indicates if the mandatory sofware update screen is disabled
watchMigrationScreenDisabledwatchMigrationScreenDisabled 布尔Boolean 指示是否禁用监视迁移屏幕Indicates if the watch migration screen is disabled
appearanceScreenDisabledappearanceScreenDisabled 布尔Boolean 指示是否禁用 Apperance 屏幕Indicates if Apperance screen is disabled
expressLanguageScreenDisabledexpressLanguageScreenDisabled 布尔Boolean 指示是否已禁用 Express 语言屏幕Indicates if Express Language screen is disabled
preferredLanguageScreenDisabledpreferredLanguageScreenDisabled 布尔Boolean 指示是否禁用首选语言屏幕Indicates if Preferred language screen is disabled
deviceToDeviceMigrationDisableddeviceToDeviceMigrationDisabled 布尔Boolean 指示是否禁用设备到设备迁移Indicates if Device To Device Migration is disabled
welcomeScreenDisabledwelcomeScreenDisabled 布尔Boolean 指示是否禁用 Weclome 屏幕Indicates if Weclome screen is disabled

响应Response

如果成功,此方法 201 Created 在响应正文中返回响应代码和 depIOSEnrollmentProfile 对象。If successful, this method returns a 201 Created response code and a depIOSEnrollmentProfile object in the response body.

示例Example

请求Request

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

POST https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles
Content-type: application/json
Content-length: 2024

{
  "@odata.type": "#microsoft.graph.depIOSEnrollmentProfile",
  "displayName": "Display Name value",
  "description": "Description value",
  "requiresUserAuthentication": true,
  "configurationEndpointUrl": "https://example.com/configurationEndpointUrl/",
  "enableAuthenticationViaCompanyPortal": true,
  "requireCompanyPortalOnSetupAssistantEnrolledDevices": true,
  "isDefault": true,
  "supervisedModeEnabled": true,
  "supportDepartment": "Support Department value",
  "passCodeDisabled": true,
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "profileRemovalDisabled": true,
  "restoreBlocked": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "zoomDisabled": true,
  "siriDisabled": true,
  "diagnosticsDisabled": true,
  "displayToneSetupDisabled": true,
  "privacyPaneDisabled": true,
  "screenTimeScreenDisabled": true,
  "deviceNameTemplate": "Device Name Template value",
  "configurationWebUrl": true,
  "iTunesPairingMode": "allow",
  "managementCertificates": [
    {
      "@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
      "thumbprint": "Thumbprint value",
      "certificate": "Certificate value"
    }
  ],
  "restoreFromAndroidDisabled": true,
  "awaitDeviceConfiguredConfirmation": true,
  "sharedIPadMaximumUserCount": 10,
  "enableSharedIPad": true,
  "companyPortalVppTokenId": "Company Portal Vpp Token Id value",
  "enableSingleAppEnrollmentMode": true,
  "homeButtonScreenDisabled": true,
  "iMessageAndFaceTimeScreenDisabled": true,
  "onBoardingScreenDisabled": true,
  "simSetupScreenDisabled": true,
  "softwareUpdateScreenDisabled": true,
  "watchMigrationScreenDisabled": true,
  "appearanceScreenDisabled": true,
  "expressLanguageScreenDisabled": true,
  "preferredLanguageScreenDisabled": true,
  "deviceToDeviceMigrationDisabled": true,
  "welcomeScreenDisabled": 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 201 Created
Content-Type: application/json
Content-Length: 2073

{
  "@odata.type": "#microsoft.graph.depIOSEnrollmentProfile",
  "id": "1ec10a60-0a60-1ec1-600a-c11e600ac11e",
  "displayName": "Display Name value",
  "description": "Description value",
  "requiresUserAuthentication": true,
  "configurationEndpointUrl": "https://example.com/configurationEndpointUrl/",
  "enableAuthenticationViaCompanyPortal": true,
  "requireCompanyPortalOnSetupAssistantEnrolledDevices": true,
  "isDefault": true,
  "supervisedModeEnabled": true,
  "supportDepartment": "Support Department value",
  "passCodeDisabled": true,
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "profileRemovalDisabled": true,
  "restoreBlocked": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "zoomDisabled": true,
  "siriDisabled": true,
  "diagnosticsDisabled": true,
  "displayToneSetupDisabled": true,
  "privacyPaneDisabled": true,
  "screenTimeScreenDisabled": true,
  "deviceNameTemplate": "Device Name Template value",
  "configurationWebUrl": true,
  "iTunesPairingMode": "allow",
  "managementCertificates": [
    {
      "@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
      "thumbprint": "Thumbprint value",
      "certificate": "Certificate value"
    }
  ],
  "restoreFromAndroidDisabled": true,
  "awaitDeviceConfiguredConfirmation": true,
  "sharedIPadMaximumUserCount": 10,
  "enableSharedIPad": true,
  "companyPortalVppTokenId": "Company Portal Vpp Token Id value",
  "enableSingleAppEnrollmentMode": true,
  "homeButtonScreenDisabled": true,
  "iMessageAndFaceTimeScreenDisabled": true,
  "onBoardingScreenDisabled": true,
  "simSetupScreenDisabled": true,
  "softwareUpdateScreenDisabled": true,
  "watchMigrationScreenDisabled": true,
  "appearanceScreenDisabled": true,
  "expressLanguageScreenDisabled": true,
  "preferredLanguageScreenDisabled": true,
  "deviceToDeviceMigrationDisabled": true,
  "welcomeScreenDisabled": true
}