Kør API til antivirusscanning
Gælder for:
Vil du opleve Microsoft Defender for Endpoint? Tilmeld dig en gratis prøveversion.
Bemærk!
Hvis du er us government-kunde, skal du bruge de URI'er, der er angivet i Microsoft Defender for Endpoint for US Government-kunder.
Tip
For at opnå en bedre ydeevne kan du bruge serveren tættere på din geografiske placering:
- 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
API-beskrivelse
Start Microsoft Defender Antivirus-scanning på en enhed.
Begrænsninger
- Hastighedsbegrænsninger for denne API er 100 opkald pr. minut og 1500 opkald pr. time.
Bemærk!
På denne side fokuseres der på at udføre en computerhandling via API. Se Udfør svarhandlinger på en computer for at få flere oplysninger om funktionalitet til svarhandlinger via Microsoft Defender for Endpoint.
Vigtigt!
- Denne handling er tilgængelig for enheder på Windows 10, version 1709 eller nyere og på Windows 11.
- En Microsoft Defender Antivirus-scanning kan køre sammen med andre antivirusløsninger, uanset om Microsoft Defender Antivirus er den aktive antivirusløsning eller ej. Microsoft Defender Antivirus kan være i passiv tilstand. Du kan få flere oplysninger under Microsoft Defender Antivirus-kompatibilitet.
Tilladelser
En af følgende tilladelser er påkrævet for at kalde denne API. Hvis du vil vide mere, herunder hvordan du vælger tilladelser, skal du se Brug Microsoft Defender til Slutpunkt-API'er
| Tilladelsestype | Tilladelse | Vist navn for tilladelse |
|---|---|---|
| Program | Machine.Scan | 'Scanningsmaskine' |
| Uddelegeret (arbejds- eller skolekonto) | Machine.Scan | 'Scanningsmaskine' |
Bemærk!
Når du henter et token ved hjælp af brugerlegitimationsoplysninger:
- Brugeren skal som minimum have følgende rolletilladelse: 'Aktive afhjælpningshandlinger' (se Opret og administrer roller for at få flere oplysninger)
- Brugeren skal have adgang til enheden baseret på indstillinger for enhedsgrupper (se Opret og administrer enhedsgrupper for at få flere oplysninger)
Oprettelse af enhedsgruppe understøttes i Defender for Endpoint Plan 1 og Plan 2.
HTTP-anmodning
POST https://api.security.microsoft.com/api/machines/{id}/runAntiVirusScan
Anmodningsheadere
| Navn | Type | Beskrivelse |
|---|---|---|
| Autorisation | String | Ihændehaver {token}. Påkrævet. |
| Indholdstype | streng | program/json |
Brødtekst i anmodning
Angiv følgende parametre for et JSON-objekt i anmodningens brødtekst:
| Parameter | Type | Beskrivelse |
|---|---|---|
| Kommenter | String | Kommentar, der skal knyttes til handlingen. Påkrævet. |
| ScanType | String | Definerer scanningstypen. Påkrævet. |
ScanType styrer den type scanning, der skal udføres, og kan være en af følgende:
- Hurtig: Udfør hurtig scanning på enheden
- Fuld: Udfør fuld scanning på enheden
Svar
Hvis det lykkes, returnerer denne metode 201, Created-svarkode og MachineAction-objekt i svarbrødteksten.
Hvis du sender flere API-kald for at køre en antivirusscanning for den samme enhed, returneres "ventende computerhandling" eller HTTP 400 med meddelelsen "Handlingen er allerede i gang".
Eksempel
Bøn
Her er et eksempel på anmodningen.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/runAntiVirusScan
{
"Comment": "Check machine for viruses due to alert 3212",
"ScanType": "Full"
}
Tip
Vil du vide mere? Kontakt Microsoft Security-community'et i vores Tech Community: Microsoft Defender for Endpoint Tech Community.