Обновление depMacOSEnrollmentProfile
Пространство имен: microsoft.graph
Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Обновите свойства объекта depMacOSEnrollmentProfile .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
| Тип разрешения | Разрешения (в порядке повышения привилегий) |
|---|---|
| Делегированные (рабочая или учебная учетная запись) | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
| Приложение | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
HTTP-запрос
PATCH /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/defaultMacOsEnrollmentProfile
Заголовки запроса
| Заголовок | Значение |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Accept | application/json |
Текст запроса
В тексте запроса укажите представление объекта depMacOSEnrollmentProfile в формате JSON.
В следующей таблице показаны свойства, необходимые при создании depMacOSEnrollmentProfile.
| Свойство | Тип | Описание |
|---|---|---|
| id | String | ИДЕНТИФИКАТОР GUID объекта , наследуемого от enrollmentProfile |
| displayName | String | Имя профиля, наследуемое от enrollmentProfile |
| description | String | Описание профиля, наследуемого от enrollmentProfile |
| requiresUserAuthentication | Логический | Указывает, требуется ли для профиля проверка подлинности пользователя Наследуется от enrollmentProfile. |
| configurationEndpointUrl | String | URL-адрес конечной точки конфигурации, используемый для регистрации, унаследованной от enrollmentProfile |
| 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 Наследуется от depEnrollmentBaseProfile. |
| termsAndConditionsDisabled | Логический | Указывает, отключена ли область установки "Условия" Наследуется от depEnrollmentBaseProfile. |
| touchIdDisabled | Логический | Указывает, отключена ли область настройки сенсорного идентификатора Наследуется от depEnrollmentBaseProfile. |
| applePayDisabled | Логический | Указывает, отключена ли панель настройки оплаты Apple Наследуется от depEnrollmentBaseProfile. |
| siriDisabled | Логический | Указывает, отключена ли область настройки siri Наследуется от depEnrollmentBaseProfile. |
| diagnosticsDisabled | Логический | Указывает, отключена ли область установки диагностика Наследуется от depEnrollmentBaseProfile. |
| displayToneSetupDisabled | Логический | Указывает, отключен ли экран настройки displaytone Наследуется от depEnrollmentBaseProfile. |
| privacyPaneDisabled | Логический | Указывает, отключен ли экран конфиденциальности Наследуется от depEnrollmentBaseProfile |
| screenTimeScreenDisabled | Логический | Указывает, отключена ли настройка времени ожидания экрана Наследуется от depEnrollmentBaseProfile. |
| deviceNameTemplate | String | Задает шаблон литерала или имени. Наследуется от depEnrollmentBaseProfile |
| configurationWebUrl | Логический | URL-адрес для настройки помощник входа наследуется от depEnrollmentBaseProfile |
| enabledSkipKeys | Коллекция строк | enabledSkipKeys содержит все включенные ключи пропуска в виде строк, унаследованных от depEnrollmentBaseProfile. |
| enrollmentTimeAzureAdGroupIds | Коллекция объектов Guid | EnrollmentTimeAzureAdGroupIds содержит список идентификаторов групп Azure для связывания с профилем, унаследованным от depEnrollmentBaseProfile |
| waitForDeviceConfiguredConfirmation | Логический | Указывает, нужно ли устройству ждать настроенного подтверждения Наследуется от depEnrollmentBaseProfile. |
| registrationDisabled | Логический | Указывает, отключена ли регистрация. |
| fileVaultDisabled | Логический | Указывает, отключено ли хранилище файлов. |
| iCloudDiagnosticsDisabled | Логический | Указывает, отключен ли экран iCloud Analytics |
| passCodeDisabled | Логический | Указывает, отключена ли область установки секретного кода. |
| zoomDisabled | Логический | Указывает, отключена ли область настройки масштабирования. |
| iCloudStorageDisabled | Логический | Указывает, отключен ли экран "Документы iCloud" и "Рабочий стол" |
| выберитеYourLockScreenDisabled | Логический | Указывает, отключен ли экран "Документы iCloud" и "Рабочий стол" |
| accessibilityScreenDisabled | Логический | Указывает, отключен ли экран специальных возможностей |
| autoUnlockWithWatchDisabled | Логический | Указывает, отключен ли экран UnlockWithWatch |
| skipPrimarySetupAccountCreation | Логический | Указывает, пропускает ли помощник по настройке пользовательский интерфейс для настройки основной учетной записи. |
| setPrimarySetupAccountAsRegularUser | Логический | Указывает, будет ли помощник по настройке устанавливать учетную запись в качестве обычного пользователя. |
| dontAutoPopulatePrimaryAccountInfo | Логический | Указывает, будет ли помощник по настройке автоматически заполнять сведения о основной учетной записи. |
| primaryAccountFullName | String | Указывает полное имя основной учетной записи. |
| primaryAccountUserName | String | Указывает имя учетной записи для основной учетной записи. |
| enableRestrictEditing | Логический | Указывает, включит ли пользователь блокировку |
| adminAccountUserName | String | Указывает имя пользователя для учетной записи администратора. |
| adminAccountFullName | String | Указывает полное имя учетной записи администратора. |
| adminAccountPassword | String | Указывает пароль для учетной записи администратора. |
| hideAdminAccount | Логический | Указывает, следует ли спрятать учетную запись администратора. |
| requestRequiresNetworkTether | Логический | Указывает, подключено ли устройство к сети для выполнения команды. |
| autoAdvanceSetupEnabled | Логический | Указывает, будет ли помощник по настройке автоматически переходить по экрану |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект depMacOSEnrollmentProfile в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
PATCH https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/defaultMacOsEnrollmentProfile
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 200 OK
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 Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по