Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
API-beskrivelse
Stop udførelsen af en fil på en enhed, og slet den.
Begrænsninger
- Hastighedsbegrænsninger for denne API er 100 opkald pr. minut og 1500 opkald pr. time.
Du kan kun udføre denne handling, hvis:
- Den enhed, du udfører handlingen på, kører Windows 10, version 1703 eller nyere eller Windows 11
- Filen tilhører ikke tredjepartsudgivere, der er tillid til, eller den er ikke signeret af Microsoft
- Microsoft Defender Antivirus skal som minimum køre i passiv tilstand. Du kan få flere oplysninger under: Microsoft Defender Antivirus-kompatibilitet.
Tilladelser
Når du henter et token ved hjælp af brugerlegitimationsoplysninger:
- Brugeren skal som minimum have følgende rolletilladelse: 'Aktive afhjælpningshandlinger'. Du kan få flere oplysninger under: Opret og administrer roller.
- Brugeren skal have adgang til enheden baseret på indstillingerne for enhedsgruppe. Du kan få flere oplysninger under: Opret og administrer enhedsgrupper.
En af følgende tilladelser er påkrævet for at kalde denne API. Du kan få mere at vide, herunder hvordan du vælger tilladelser, under Brug Microsoft Defender for Endpoint API'er
| Tilladelsestype | Tilladelse | Vist navn for tilladelse |
|---|---|---|
| Program | Machine.StopAndQuarantine | 'Stop og sæt dem i karantæne' |
| Program | Machine.ReadWrite.All | 'Læs og skriv alle computeroplysninger' |
| Uddelegeret (arbejds- eller skolekonto) | Machine.StopAndQuarantine | 'Stop og sæt dem i karantæne' |
HTTP-anmodning
POST https://api.security.microsoft.com/api/machines/{id}/StopAndQuarantineFile
Anmodningsheadere
| Navn | Type | Beskrivelse |
|---|---|---|
| Autorisation | String | Ihændehaver {token}. Påkrævet. |
| Indholdstype | streng | application/json. Påkrævet. |
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. |
| Sha1 | String | Sha1 af filen for at stoppe og sætte enheden i karantæne. Påkrævet. |
Svar
Hvis det lykkes, returnerer denne metode 201 – Oprettet svarkode og Computerhandling i svarbrødteksten.
Eksempel
Bøn
Her er et eksempel på anmodningen.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/StopAndQuarantineFile
{
"Comment": "Stop and quarantine file on machine due to alert 441688558380765161_2136280442",
"Sha1": "87662bc3d60e4200ceaf7aae249d1c343f4b83c9"
}