> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Antivirus Scan

Initiate Microsoft Defender Antivirus scan on a machine.

Microsoft WindowsDefenderATP permissions to access the action via **application**: `Machine.Scan`.

<Note>
  External Documentation

  To learn more, visit the [Microsoft Defender For Endpoints documentation](https://learn.microsoft.com/en-us/defender-endpoint/api/run-av-scan).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter  | Description                                                                                     |
  | ---------- | ----------------------------------------------------------------------------------------------- |
  | Comment    | A comment to associate with the action.                                                         |
  | Machine ID | The ID of the machine to initiate a scan for. Can be obtained using the `List Machines` action. |
  | Scan Type  | Select the type of the scan.                                                                    |
</div>

## Example Output

```json theme={"dark"}
{
	"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineActions/$entity",
	"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
	"type": "RunAntiVirusScan",
	"title": null,
	"requestor": "user@example.com",
	"requestorComment": "Routine security scan following suspicious network activity",
	"status": "InProgress",
	"machineId": "cd9f8e7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e",
	"computerDnsName": "workstation-42.corporate.local",
	"creationDateTimeUtc": "2025-06-29T14:16:05.9855884Z",
	"lastUpdateDateTimeUtc": "2025-06-29T14:16:05.9855888Z",
	"cancellationRequestor": null,
	"cancellationComment": null,
	"cancellationDateTimeUtc": null,
	"errorHResult": 0,
	"scope": null,
	"externalId": null,
	"requestSource": "Portal",
	"relatedFileInfo": null,
	"commands": [],
	"troubleshootInfo": null
}
```

## Workflow Library Example

[Run Antivirus Scan with Microsoft Defender for Endpoints and Send Results Via Email](https://library.blinkops.com/workflows/run-antivirus-scan-with-microsoft-defender-for-endpoints-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/run-antivirus-scan-with-microsoft-defender-for-endpoints-and-send-results-via-email/canvas" />
</div>