Создание macOSSoftwareUpdateConfiguration
Пространство имен: microsoft.graph
Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Создайте новый объект macOSSoftwareUpdateConfiguration .
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | DeviceManagementConfiguration.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Приложение | DeviceManagementConfiguration.ReadWrite.All |
HTTP-запрос
POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
Заголовки запроса
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Accept | application/json |
Текст запроса
В тексте запроса укажите представление объекта macOSSoftwareUpdateConfiguration в формате JSON.
В следующей таблице показаны свойства, необходимые при создании macOSSoftwareUpdateConfiguration.
Свойство | Тип | Описание |
---|---|---|
id | String | Ключ объекта. Наследуется от объекта deviceConfiguration. |
lastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения объекта. Наследуется от объекта deviceConfiguration. |
roleScopeTagIds | Коллекция строк | Список тегов области для этого экземпляра сущности. Наследуется от объекта deviceConfiguration. |
supportsScopeTags | Логический | Указывает, поддерживает ли базовая конфигурация устройства назначение тегов область. Назначение свойству ScopeTags не допускается, если это значение равно false, а сущности не будут видны пользователям с областью действия. Это происходит для устаревших политик, созданных в Silverlight, и его можно устранить путем удаления и повторного создания политики на портале Azure. Это свойство доступно только для чтения. Наследуется от объекта deviceConfiguration. |
deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Применимость выпуска ОС для этой политики. Наследуется от объекта deviceConfiguration. |
deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Правило применимости версий ОС для этой политики. Наследуется от объекта deviceConfiguration. |
deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Правило применимости режима устройства для этой политики. Наследуется от объекта deviceConfiguration. |
createdDateTime | DateTimeOffset | Дата и время создания объекта. Наследуется от объекта deviceConfiguration. |
description | String | Указанное администратором описание конфигурации устройства. Наследуется от объекта deviceConfiguration. |
displayName | String | Указанное администратором имя конфигурации устройства. Наследуется от объекта deviceConfiguration. |
version | Int32 | Версия конфигурации устройства. Наследуется от объекта deviceConfiguration. |
criticalUpdateBehavior | macOSSoftwareUpdateBehavior | Поведение обновлений для критических обновлений. Возможные значения: notConfigured , default , downloadOnly , installASAP , notifyOnly , installLater . |
configDataUpdateBehavior | macOSSoftwareUpdateBehavior | Поведение обновления для обновления файла данных конфигурации. Возможные значения: notConfigured , default , downloadOnly , installASAP , notifyOnly , installLater . |
FirmwareUpdateBehavior | macOSSoftwareUpdateBehavior | Поведение обновления для обновлений встроенного ПО. Возможные значения: notConfigured , default , downloadOnly , installASAP , notifyOnly , installLater . |
allOtherUpdateBehavior | macOSSoftwareUpdateBehavior | Поведение обновлений для всех остальных обновлений. Возможные значения: notConfigured , default , downloadOnly , installASAP , notifyOnly , installLater . |
updateScheduleType | macOSSoftwareUpdateScheduleType | Тип расписания обновления. Возможные значения: alwaysUpdate , updateDuringTimeWindows , updateOutsideOfTimeWindows . |
customUpdateTimeWindows | коллекция customUpdateTimeWindow | Настраиваемое время, когда обновления будут разрешены или заблокированы. Эта коллекция может содержать не более 20 элементов. |
updateTimeWindowUtcOffsetInMinutes | Int32 | Минуты, указывающие смещение в формате UTC для каждого окна времени обновления |
maxUserDeferralsCount | Int32 | Максимальное количество раз, когда система позволяет пользователю отложить обновление перед установкой. Поддерживаемые значения: от 0 до 366. Допустимые значения от 0 до 365 |
priority | macOSPriority | Приоритет планирования для скачивания и подготовки запрошенного обновления. По умолчанию: Низкий. Возможные значения: Null, Low, High. Возможные значения: low , high , unknownFutureValue . |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 201 Created
и объект macOSSoftwareUpdateConfiguration в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 1596
{
"@odata.type": "#microsoft.graph.macOSSoftwareUpdateConfiguration",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"criticalUpdateBehavior": "default",
"configDataUpdateBehavior": "default",
"firmwareUpdateBehavior": "default",
"allOtherUpdateBehavior": "default",
"updateScheduleType": "updateDuringTimeWindows",
"customUpdateTimeWindows": [
{
"@odata.type": "microsoft.graph.customUpdateTimeWindow",
"startDay": "monday",
"endDay": "monday",
"startTime": "12:03:30.2730000",
"endTime": "12:03:02.3740000"
}
],
"updateTimeWindowUtcOffsetInMinutes": 2,
"maxUserDeferralsCount": 5,
"priority": "high"
}
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1768
{
"@odata.type": "#microsoft.graph.macOSSoftwareUpdateConfiguration",
"id": "b8e467ac-67ac-b8e4-ac67-e4b8ac67e4b8",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"criticalUpdateBehavior": "default",
"configDataUpdateBehavior": "default",
"firmwareUpdateBehavior": "default",
"allOtherUpdateBehavior": "default",
"updateScheduleType": "updateDuringTimeWindows",
"customUpdateTimeWindows": [
{
"@odata.type": "microsoft.graph.customUpdateTimeWindow",
"startDay": "monday",
"endDay": "monday",
"startTime": "12:03:30.2730000",
"endTime": "12:03:02.3740000"
}
],
"updateTimeWindowUtcOffsetInMinutes": 2,
"maxUserDeferralsCount": 5,
"priority": "high"
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по