Создание unmanagedDeviceDiscoveryTask

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

Важный: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.

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

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

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

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

Разрешения

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

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

HTTP-запрос

POST /deviceAppManagement/deviceAppManagementTasks

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

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

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

В тексте запроса укажите представление json для объекта unmanagedDeviceDiscoveryTask.

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

Свойство	Тип	Описание
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.
неуправляемыеdevices	Коллекция unmanagedDevice	Неуправляемые устройства, обнаруженные в сети.

Отклик

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

Пример

Запрос

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

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

{
  "@odata.type": "#microsoft.graph.unmanagedDeviceDiscoveryTask",
  "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",
  "unmanagedDevices": [
    {
      "@odata.type": "microsoft.graph.unmanagedDevice",
      "os": "Os value",
      "osVersion": "Os Version value",
      "ipAddress": "Ip Address value",
      "deviceName": "Device Name value",
      "macAddress": "Mac Address value",
      "domain": "Domain value",
      "manufacturer": "Manufacturer value",
      "model": "Model value",
      "location": "Location value",
      "lastLoggedOnUser": "Last Logged On User value",
      "lastSeenDateTime": "2017-01-01T00:02:00.1006212-08:00"
    }
  ]
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.unmanagedDeviceDiscoveryTask",
  "id": "6caa2ba0-2ba0-6caa-a02b-aa6ca02baa6c",
  "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",
  "unmanagedDevices": [
    {
      "@odata.type": "microsoft.graph.unmanagedDevice",
      "os": "Os value",
      "osVersion": "Os Version value",
      "ipAddress": "Ip Address value",
      "deviceName": "Device Name value",
      "macAddress": "Mac Address value",
      "domain": "Domain value",
      "manufacturer": "Manufacturer value",
      "model": "Model value",
      "location": "Location value",
      "lastLoggedOnUser": "Last Logged On User value",
      "lastSeenDateTime": "2017-01-01T00:02:00.1006212-08:00"
    }
  ]
}