创建 depMacOSEnrollmentProfile
命名空间：microsoft.graph
重要： /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
创建新的 depMacOSEnrollmentProfile 对象。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 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 |
请求正文
在请求正文中，提供 depMacOSEnrollmentProfile 对象的 JSON 表示形式。
下表显示了创建 depMacOSEnrollmentProfile 时所需的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| 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 |
| registrationDisabled | 布尔值 | 指示是否禁用注册 |
| fileVaultDisabled | 布尔值 | 指示是否禁用文件保管库 |
| iCloudDiagnosticsDisabled | 布尔值 | 指示 iCloud Analytics 屏幕是否已禁用 |
| passCodeDisabled | 布尔值 | 指示是否禁用密码设置窗格 |
| zoomDisabled | 布尔值 | 指示缩放设置窗格是否已禁用 |
| iCloudStorageDisabled | 布尔值 | 指示是否禁用 iCloud 文档和桌面屏幕 |
| chooseYourLockScreenDisabled | 布尔值 | 指示是否禁用 iCloud 文档和桌面屏幕 |
| accessibilityScreenDisabled | 布尔值 | 指示是否禁用辅助功能屏幕 |
| autoUnlockWithWatchDisabled | 布尔值 | 指示是否禁用 UnlockWithWatch 屏幕 |
| skipPrimarySetupAccountCreation | 布尔值 | 指示设置助理是否会跳过主帐户设置的用户界面 |
| setPrimarySetupAccountAsRegularUser | 布尔值 | 指示设置助理是否将帐户设置为普通用户 |
| dontAutoPopulatePrimaryAccountInfo | 布尔值 | 指示设置助理是否会自动填充主帐户信息 |
| primaryAccountFullName | String | 指示主帐户的全名 |
| primaryAccountUserName | String | 指示主帐户的帐户名称 |
| enableRestrictEditing | 布尔值 | 指示用户是否将启用阻止编辑 |
| adminAccountUserName | String | 指示管理员帐户的用户名 |
| adminAccountFullName | String | 指示管理员帐户的全名 |
| adminAccountPassword | String | 指示管理员帐户的密码 |
| hideAdminAccount | 布尔值 | 指示是否应隐藏管理员帐户 |
| requestRequiresNetworkTether | 布尔值 | 指示设备是否通过网络网络来运行命令 |
| autoAdvanceSetupEnabled | 布尔值 | 指示设置助理是否会自动通过其屏幕前进 |
响应
如果成功，此方法在 201 Created 响应正文中返回响应代码和 depMacOSEnrollmentProfile 对象。
示例
请求
下面是一个请求示例。
POST https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles
Content-type: application/json
Content-length: 2123
{
"@odata.type": "#microsoft.graph.depMacOSEnrollmentProfile",
"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,
"registrationDisabled": true,
"fileVaultDisabled": true,
"iCloudDiagnosticsDisabled": true,
"passCodeDisabled": true,
"zoomDisabled": true,
"iCloudStorageDisabled": true,
"chooseYourLockScreenDisabled": true,
"accessibilityScreenDisabled": true,
"autoUnlockWithWatchDisabled": true,
"skipPrimarySetupAccountCreation": true,
"setPrimarySetupAccountAsRegularUser": true,
"dontAutoPopulatePrimaryAccountInfo": true,
"primaryAccountFullName": "Primary Account Full Name value",
"primaryAccountUserName": "Primary Account User Name value",
"enableRestrictEditing": true,
"adminAccountUserName": "Admin Account User Name value",
"adminAccountFullName": "Admin Account Full Name value",
"adminAccountPassword": "Admin Account Password value",
"hideAdminAccount": true,
"requestRequiresNetworkTether": true,
"autoAdvanceSetupEnabled": true
}
响应
下面是一个响应示例。 注意：为简洁起见，可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 2172
{
"@odata.type": "#microsoft.graph.depMacOSEnrollmentProfile",
"id": "e433c95c-c95c-e433-5cc9-33e45cc933e4",
"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,
"registrationDisabled": true,
"fileVaultDisabled": true,
"iCloudDiagnosticsDisabled": true,
"passCodeDisabled": true,
"zoomDisabled": true,
"iCloudStorageDisabled": true,
"chooseYourLockScreenDisabled": true,
"accessibilityScreenDisabled": true,
"autoUnlockWithWatchDisabled": true,
"skipPrimarySetupAccountCreation": true,
"setPrimarySetupAccountAsRegularUser": true,
"dontAutoPopulatePrimaryAccountInfo": true,
"primaryAccountFullName": "Primary Account Full Name value",
"primaryAccountUserName": "Primary Account User Name value",
"enableRestrictEditing": true,
"adminAccountUserName": "Admin Account User Name value",
"adminAccountFullName": "Admin Account Full Name value",
"adminAccountPassword": "Admin Account Password value",
"hideAdminAccount": true,
"requestRequiresNetworkTether": true,
"autoAdvanceSetupEnabled": true
}
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈