Share via


Stop og sæt fil-API'en i karantæne

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

API-beskrivelse

Stop udførelsen af en fil på en enhed, og slet den.

Begrænsninger

  1. 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!

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

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.Read.All 'Læs alle computerprofiler'
Program Machine.ReadWrite.All 'Læs og skriv alle computeroplysninger'
Uddelegeret (arbejds- eller skolekonto) Machine.StopAndQuarantine 'Stop og sæt dem i karantæne'

Bemærk!

Når du henter et token ved hjælp af brugerlegitimationsoplysninger:

Oprettelse af enhedsgruppe understøttes i Defender for Endpoint Plan 1 og Plan 2.

HTTP-anmodning

POST https://api.securitycenter.microsoft.com/api/machines/{id}/StopAndQuarantineFile

Anmodningsheadere

Navn Type Beskrivelse
Tilladelse 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

Anmodning

Her er et eksempel på anmodningen.

POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/StopAndQuarantineFile 
{
  "Comment": "Stop and quarantine file on machine due to alert 441688558380765161_2136280442",
  "Sha1": "87662bc3d60e4200ceaf7aae249d1c343f4b83c9"
}

Tip

Vil du vide mere? Engage med Microsoft Security-community'et i vores tech-community: Microsoft Defender for Endpoint Tech Community.