Поделиться через

Тип ресурса компьютера

  • Статья

Область применения:

Хотите попробовать Microsoft Defender для конечной точки? Зарегистрироваться для бесплатной пробной версии.

Примечание.

Если вы являетесь клиентом для государственных организаций США, используйте URI, перечисленные в Microsoft Defender для конечной точки для клиентов государственных организаций США.

Совет

Для повышения производительности можно использовать сервер ближе к географическому расположению:

  • us.api.security.microsoft.com
  • eu.api.security.microsoft.com
  • uk.api.security.microsoft.com
  • au.api.security.microsoft.com
  • swa.api.security.microsoft.com
  • ina.api.security.microsoft.com

Важно!

Некоторые сведения относятся к предварительно выпущенному продукту, который может быть существенно изменен перед выпуском. Корпорация Майкрософт не дает явных или подразумеваемых гарантий относительно предоставленных здесь сведений.

Методы

Метод Возвращаемый тип Описание
Список компьютеров коллекция компьютеров Перечисление набора сущностей компьютера в организации.
Получение компьютера машина Получение компьютера по его идентификатору.
Получение входа пользователей Коллекция объектов user Получите набор пользователей , выполнивший вход на компьютер.
Получение связанных оповещений Коллекция alert Получите набор сущностей оповещений , которые были созданы на компьютере.
Получить установленное программное обеспечение коллекция программного обеспечения Извлекает коллекцию установленного программного обеспечения, связанного с заданным идентификатором компьютера.
Получить обнаруженные уязвимости коллекция уязвимостей Извлекает коллекцию обнаруженных уязвимостей, связанных с заданным идентификатором компьютера.
Получить рекомендации по безопасности коллекция рекомендаций Извлекает коллекцию рекомендаций по безопасности, связанных с заданным идентификатором компьютера.
Добавление и удаление тегов компьютера машина Добавление или удаление тега на определенный компьютер.
Поиск компьютеров по протоколу IP коллекция компьютеров Поиск компьютеров, видимых с ПОМОЩЬЮ IP-адреса.
Поиск компьютеров по тегу коллекция компьютеров Поиск компьютеров по тегу.
Получить недостающие КБ Коллекция базы знаний Получение списка отсутствующих КБ, связанных с идентификатором компьютера
Установить значение устройства коллекция компьютеров Задайте значение устройства.
Обновление компьютера коллекция компьютеров Получение состояния обновления компьютера.

Свойства

Свойство Тип Описание
id String удостоверение компьютера.
computerDnsName String полное имя компьютера.
firstSeen DateTimeOffset Первая дата и время наблюдения за компьютером в Microsoft Defender для конечной точки.
lastSeen DateTimeOffset Время и дата последнего получения полного отчета об устройстве. Устройство обычно отправляет полный отчет каждые 24 часа.
ПРИМЕЧАНИЕ. Это свойство не соответствует последнему просмотренное значение в пользовательском интерфейсе. Он относится к последнему обновлению устройства.
osPlatform String Платформа операционной системы.
onboardingstatus String Состояние подключения компьютера. Возможные значения: onboarded, CanBeOnboarded, Unsupported и InsufficientInfo.
osProcessor String Процессор операционной системы. Вместо этого используйте свойство osArchitecture.
version String Версия операционной системы.
osBuild Длинный, допускающий значение NULL Номер сборки операционной системы.
lastIpAddress String Последний IP-адрес на локальном сетевом адаптере на компьютере.
lastExternalIpAddress String Последний IP-адрес, через который компьютер обращается к Интернету.
healthStatus Перечисление состояние работоспособности компьютера. Возможные значения: Active, Inactive, ImpairedCommunication, NoSensorData, NoSensorDataImpairedCommunicationи Unknown.
rbacGroupName String Имя группы компьютера.
rbacGroupId String Идентификатор группы компьютера.
riskScore Перечисление, допускающее значение NULL Оценка риска, оцениваемая Microsoft Defender для конечной точки. Возможные значения: None, Informational, Low, Mediumи High.
aadDeviceId Guid представления, допускающее значение NULL Идентификатор устройства Microsoft Entra (если компьютер присоединен к Microsoft Entra).
machineTags Коллекция строк Набор тегов компьютера .
exposureLevel Перечисление, допускающее значение NULL Уровень уязвимости, оцениваемый Microsoft Defender для конечной точки. Возможные значения: None, Low, Medium и High.
deviceValue Перечисление, допускающее значение NULL Значение устройства. Возможные значения: Normal, Lowи High.
ipAddresses Коллекция IpAddress Набор объектов IpAddress . См . раздел Получение API компьютеров.
osArchitecture String Архитектура операционной системы. Возможные значения: 32-bit, 64-bit. Используйте это свойство вместо osProcessor.

Совет

Хотите узнать больше? Обратитесь к сообществу Майкрософт по безопасности в техническом сообществе Microsoft Defender для конечной точки Tech Community.