Microsoft Defender API icon

Microsoft Defender API

Interact with the Microsoft Defender API

Machine Action → Run Antivirus Scan

AI-generated

Summary

Run an antivirus scan on a specified machine in Microsoft Defender by providing the machine ID, scan type, and an associated comment.

Inputs

  • Machine ID (required) — The ID of the device to run the antivirus scan on.
  • Scan Type (required) — The type of antivirus scan to perform, either Quick (for a quick scan) or Full (for a full system scan).
  • Comment (required) — A comment associated with the antivirus scan action.

Output shape

a single record containing the API response to the antivirus scan initiation request

The output reflects the response from the Microsoft Defender API endpoint POST /api/machines/{machineId}/runAntivirusScan indicating the result or status of the scan action.

Links

Discussion