Создание securityConfigurationTask

Пространство имен: microsoft.graph

Важно: Корпорация Майкрософт поддерживает api Intune /beta, но они могут часто изменяться. Корпорация Майкрософт рекомендует по возможности использовать версию 1.0. Проверьте доступность API в версии 1.0 с помощью селектора версий.

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Создайте объект securityConfigurationTask .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	DeviceManagementApps.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Приложение	DeviceManagementApps.ReadWrite.All

HTTP-запрос

POST /deviceAppManagement/deviceAppManagementTasks

Заголовки запроса

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept	application/json

Текст запроса

В тексте запроса укажите представление объекта securityConfigurationTask в формате JSON.

В следующей таблице показаны свойства, необходимые при создании securityConfigurationTask.

Свойство	Тип	Описание
id	String	Ключ сущности. Наследуется от deviceAppManagementTask
displayName	String	Имя. Наследуется от deviceAppManagementTask
description	String	Описание. Наследуется от deviceAppManagementTask
createdDateTime	DateTimeOffset	Дата создания. Наследуется от deviceAppManagementTask
dueDateTime	DateTimeOffset	Дата выполнения. Наследуется от deviceAppManagementTask
category	deviceAppManagementTaskCategory	Категория. Наследуется от deviceAppManagementTask. Возможные значения: unknown, advancedThreatProtection.
priority	deviceAppManagementTaskPriority	Приоритет. Наследуется от deviceAppManagementTask. Возможные значения: none, high, low.
creator	String	Адрес электронной почты создателя. Наследуется от deviceAppManagementTask
creatorNotes	String	Заметки от создателя. Наследуется от deviceAppManagementTask
assignedTo	String	Имя или адрес электронной почты администратора, которому назначена эта задача. Наследуется от deviceAppManagementTask
status	deviceAppManagementTaskStatus	Состояние. Наследуется от deviceAppManagementTask. Возможные значения: unknown, pending, active, completed, rejected.
endpointSecurityPolicy	endpointSecurityConfigurationType	Тип политики безопасности конечной точки. Возможные значения: unknown, antivirus, diskEncryption, firewall, endpointDetectionAndResponse, attackSurfaceReduction, accountProtection.
applicablePlatform	endpointSecurityConfigurationApplicablePlatform	Применимая платформа. Возможные значения: unknown, macOS, windows10AndLater, windows10AndWindowsServer.
EndpointSecurityPolicyProfile	endpointSecurityConfigurationProfileType	Профиль политики безопасности конечной точки. Возможные значения: unknown, , windowsSecurityantivirus, bitLocker, fileVault, firewall, firewallRules, , endpointDetectionAndResponse, deviceControl, appAndBrowserIsolation, exploitProtection, webProtection, applicationControl, , attackSurfaceReductionRules, . accountProtection
insights	String	Сведения о мерах по устранению рисков.
managedDeviceCount	Int32	Количество уязвимых устройств.
intendedSettings	Коллекция keyValuePair	Предполагаемые параметры и их значения.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект securityConfigurationTask в теле отклика.

Пример

Запрос

Ниже приведен пример запроса.

POST https://graph.microsoft.com/beta/deviceAppManagement/deviceAppManagementTasks
Content-type: application/json
Content-length: 746

{
  "@odata.type": "#microsoft.graph.securityConfigurationTask",
  "displayName": "Display Name value",
  "description": "Description value",
  "dueDateTime": "2017-01-01T00:02:18.1994089-08:00",
  "category": "advancedThreatProtection",
  "priority": "high",
  "creator": "Creator value",
  "creatorNotes": "Creator Notes value",
  "assignedTo": "Assigned To value",
  "status": "pending",
  "endpointSecurityPolicy": "antivirus",
  "applicablePlatform": "macOS",
  "endpointSecurityPolicyProfile": "antivirus",
  "insights": "Insights value",
  "managedDeviceCount": 2,
  "intendedSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ]
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

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

{
  "@odata.type": "#microsoft.graph.securityConfigurationTask",
  "id": "5d630f12-0f12-5d63-120f-635d120f635d",
  "displayName": "Display Name value",
  "description": "Description value",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "dueDateTime": "2017-01-01T00:02:18.1994089-08:00",
  "category": "advancedThreatProtection",
  "priority": "high",
  "creator": "Creator value",
  "creatorNotes": "Creator Notes value",
  "assignedTo": "Assigned To value",
  "status": "pending",
  "endpointSecurityPolicy": "antivirus",
  "applicablePlatform": "macOS",
  "endpointSecurityPolicyProfile": "antivirus",
  "insights": "Insights value",
  "managedDeviceCount": 2,
  "intendedSettings": [
    {
      "@odata.type": "microsoft.graph.keyValuePair",
      "name": "Name value",
      "value": "Value value"
    }
  ]
}