创建 depIOSEnrollmentProfile

项目
01/22/2024

命名空间：microsoft.graph

重要： /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。

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

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

权限

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

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

HTTP 请求

POST /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles

请求标头

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

请求正文

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

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

属性	类型	说明
id	String	对象的 GUID 继承自 enrollmentProfile
displayName	String	从 enrollmentProfile 继承的配置文件的名称
说明	String	配置文件的说明继承自 enrollmentProfile
requiresUserAuthentication	布尔值	指示配置文件是否需要用户身份验证继承自 enrollmentProfile
configurationEndpointUrl	String	用于注册继承自 enrollmentProfile 的配置终结点 URL
enableAuthenticationViaCompanyPortal	布尔值	指示使用 Apple 设置助理而不是公司门户进行身份验证。继承自 enrollmentProfile
requireCompanyPortalOnSetupAssistantEnrolledDevices	布尔值	指示在安装助手从 enrollmentProfile 继承的注册设备上需要公司门户
isDefault	布尔值	指示此配置文件是否是继承自 depEnrollmentBaseProfile 的默认配置文件
supervisedModeEnabled	布尔值	监督模式，如果为 True，则为启用，否则为 false。有关详细信息，请参阅 https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune 。继承自 depEnrollmentBaseProfile
supportDepartment	String	从 depEnrollmentBaseProfile 继承的支持部门信息
isMandatory	布尔值	指示配置文件是否是必需的继承自 depEnrollmentBaseProfile
locationDisabled	布尔值	指示是否禁用“位置服务设置”窗格，“继承自 depEnrollmentBaseProfile”
supportPhoneNumber	String	支持电话号码继承自 depEnrollmentBaseProfile
profileRemovalDisabled	布尔值	指示配置文件删除选项是否禁用“继承自 depEnrollmentBaseProfile”
restoreBlocked	布尔值	指示是否阻止“还原设置”窗格继承自 depEnrollmentBaseProfile
appleIdDisabled	布尔值	指示是否禁用 Apple ID 设置窗格继承自 depEnrollmentBaseProfile
termsAndConditionsDisabled	布尔值	指示是否禁用“条款和条件”设置窗格继承自 depEnrollmentBaseProfile
touchIdDisabled	布尔值	指示触摸 ID 设置窗格是否被禁用，继承自 depEnrollmentBaseProfile
applePayDisabled	布尔值	指示 Apple 付费设置窗格是否已禁用，继承自 depEnrollmentBaseProfile
siriDisabled	布尔值	指示是否禁用 siri 设置窗格继承自 depEnrollmentBaseProfile
diagnosticsDisabled	布尔值	指示是否禁用诊断安装窗格继承自 depEnrollmentBaseProfile
displayToneSetupDisabled	布尔值	指示是否禁用了“显示色调设置”屏幕，“继承自 depEnrollmentBaseProfile”
privacyPaneDisabled	布尔值	指示是否禁用隐私屏幕继承自 depEnrollmentBaseProfile
screenTimeScreenDisabled	布尔值	指示是否禁用屏幕超时设置继承自 depEnrollmentBaseProfile
deviceNameTemplate	String	设置文本或名称模式。继承自 depEnrollmentBaseProfile
configurationWebUrl	布尔值	安装程序助手登录名的 URL 继承自 depEnrollmentBaseProfile
enabledSkipKeys	字符串集合	enabledSkipKeys 包含所有启用的跳过键作为字符串继承自 depEnrollmentBaseProfile
enrollmentTimeAzureAdGroupIds	Guid 集合	EnrollmentTimeAzureAdGroupIds 包含与从 depEnrollmentBaseProfile 继承的配置文件关联的注册时间列表
waitForDeviceConfiguredConfirmation	布尔值	指示设备是否需要等待配置的确认继承自 depEnrollmentBaseProfile
iTunesPairingMode	iTunesPairingMode	指示 iTunes 配对模式。可取值为：`disallow`、`allow`、`requiresCertificate`。
managementCertificates	managementCertificateWithThumbprint 集合	Apple Configurator 的管理证书
restoreFromAndroidDisabled	布尔值	指示是否禁用从 Android 还原
awaitDeviceConfiguredConfirmation	布尔值	指示设备是否需要等待配置的确认
sharedIPadMaximumUserCount	Int32	这指定可以使用共享 iPad 的最大用户数。仅适用于共享 iPad 模式。
enableSharedIPad	布尔值	这指示设备是否在启用多用户方案的模式下注册。仅适用于共享 iPad。
companyPortalVppTokenId	String	如果已设置，则指示应使用哪个 Vpp 令牌来部署具有设备许可的公司门户。必须设置“enableAuthenticationViaCompanyPortal”才能设置此属性。
enableSingleAppEnrollmentMode	布尔值	指示设备在注册期间启用单应用模式并应用应用锁。默认为 false。必须设置“enableAuthenticationViaCompanyPortal”和“companyPortalVppTokenId”才能设置此属性。
homeButtonScreenDisabled	布尔值	指示是否禁用了主页按钮敏感度屏幕
iMessageAndFaceTimeScreenDisabled	布尔值	指示是否禁用 iMessage 和 FaceTime 屏幕
onBoardingScreenDisabled	布尔值	指示是否禁用了载入设置屏幕
simSetupScreenDisabled	布尔值	指示 SIMSetup 屏幕是否已禁用
softwareUpdateScreenDisabled	布尔值	指示是否禁用强制软件更新屏幕
watchMigrationScreenDisabled	布尔值	指示是否禁用watch迁移屏幕
appearanceScreenDisabled	布尔值	指示应用屏幕是否处于禁用状态
expressLanguageScreenDisabled	布尔值	指示是否禁用“快速语言”屏幕
preferredLanguageScreenDisabled	布尔值	指示是否禁用首选语言屏幕
deviceToDeviceMigrationDisabled	布尔值	指示是否禁用设备到设备迁移
welcomeScreenDisabled	布尔值	指示是否禁用了 Weclome 屏幕
passCodeDisabled	布尔值	指示是否禁用密码设置窗格
zoomDisabled	布尔值	指示缩放设置窗格是否已禁用
restoreCompletedScreenDisabled	布尔值	指示是否禁用了 Weclome 屏幕
updateCompleteScreenDisabled	布尔值	指示是否禁用了 Weclome 屏幕
forceTemporarySession	布尔值	指示是否启用了临时会话
temporarySessionTimeoutInSeconds	Int32	指示临时会话的超时
userSessionTimeoutInSeconds	Int32	指示临时会话的超时
密码LockGracePeriodInSeconds	Int32	指示锁定屏幕前的超时要求用户输入设备密码才能解锁设备
carrierActivationUrl	String	用于激活设备 eSIM 的运营商 URL。
userlessSharedAadModeEnabled	布尔值	指示此 apple 设备被指定为支持“共享设备模式”方案。这与“共享 iPad”方案不同。请参阅 https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios\|

响应

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

示例

请求

下面是一个请求示例。

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

{
  "@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",
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "profileRemovalDisabled": true,
  "restoreBlocked": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "siriDisabled": true,
  "diagnosticsDisabled": true,
  "displayToneSetupDisabled": true,
  "privacyPaneDisabled": true,
  "screenTimeScreenDisabled": true,
  "deviceNameTemplate": "Device Name Template value",
  "configurationWebUrl": true,
  "enabledSkipKeys": [
    "Enabled Skip Keys value"
  ],
  "enrollmentTimeAzureAdGroupIds": [
    "7f64eb6c-eb6c-7f64-6ceb-647f6ceb647f"
  ],
  "waitForDeviceConfiguredConfirmation": 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,
  "passCodeDisabled": true,
  "zoomDisabled": true,
  "restoreCompletedScreenDisabled": true,
  "updateCompleteScreenDisabled": true,
  "forceTemporarySession": true,
  "temporarySessionTimeoutInSeconds": 0,
  "userSessionTimeoutInSeconds": 11,
  "passcodeLockGracePeriodInSeconds": 0,
  "carrierActivationUrl": "https://example.com/carrierActivationUrl/",
  "userlessSharedAadModeEnabled": true
}

响应

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

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 2623

{
  "@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",
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "profileRemovalDisabled": true,
  "restoreBlocked": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "siriDisabled": true,
  "diagnosticsDisabled": true,
  "displayToneSetupDisabled": true,
  "privacyPaneDisabled": true,
  "screenTimeScreenDisabled": true,
  "deviceNameTemplate": "Device Name Template value",
  "configurationWebUrl": true,
  "enabledSkipKeys": [
    "Enabled Skip Keys value"
  ],
  "enrollmentTimeAzureAdGroupIds": [
    "7f64eb6c-eb6c-7f64-6ceb-647f6ceb647f"
  ],
  "waitForDeviceConfiguredConfirmation": 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,
  "passCodeDisabled": true,
  "zoomDisabled": true,
  "restoreCompletedScreenDisabled": true,
  "updateCompleteScreenDisabled": true,
  "forceTemporarySession": true,
  "temporarySessionTimeoutInSeconds": 0,
  "userSessionTimeoutInSeconds": 11,
  "passcodeLockGracePeriodInSeconds": 0,
  "carrierActivationUrl": "https://example.com/carrierActivationUrl/",
  "userlessSharedAadModeEnabled": true
}

创建 depIOSEnrollmentProfile

权限

HTTP 请求

请求标头

请求正文

响应

示例

请求

响应

反馈

反馈

其他资源