Lista alla åtgärdsaktiviteter
Gäller för:
- Microsoft Defender för Endpoint Abonnemang 1
- Microsoft Defender för Endpoint Abonnemang 2
- Hantering av hot och säkerhetsrisker för Microsoft Defender
- Microsoft Defender XDR
Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.
Vill du uppleva Microsoft Defender – hantering av säkerhetsrisker? Läs mer om hur du kan registrera dig för Microsoft Defender – hantering av säkerhetsrisker utvärderingsversion av den offentliga förhandsversionen.
Viktigt
Viss information i den här artikeln gäller en förhyrd produkt som kan ändras avsevärt innan den släpps kommersiellt. Microsoft lämnar inga garantier, uttryckta eller underförstådda, med avseende på den information som tillhandahålls här.
Obs!
Om du är en us government-kund använder du de URI:er som anges i Microsoft Defender för Endpoint för amerikanska myndighetskunder.
Tips
För bättre prestanda kan du använda servern närmare din geoplats:
- 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-beskrivning
Returnerar information om alla reparationsaktiviteter.
Läs mer om reparationsaktiviteter.
URL: GET: /api/remediationTasks
Stöder OData V4-frågor.
Operatorer som stöds av OData:$filter
på: createdon
och status
egenskaper.
$top
med maxvärdet 10 000.
$skip
.
Se exempel på OData-frågor med Microsoft Defender för Endpoint.
Behörigheter
En av följande behörigheter krävs för att anropa det här API:et. Mer information om hur du väljer behörigheter finns i Använda Microsoft Defender för Endpoint-API:er.
Behörighetstyp | Behörighet | Visningsnamn för behörighet |
---|---|---|
Program | RemediationTasks.Read.All | "Läs information om sårbarhetshantering för hot och sårbarhetshantering" |
Delegerat (arbets- eller skolkonto) | RemediationTask.Read | "Läs information om sårbarhetshantering för hot och sårbarhetshantering" |
Egenskaper
Egenskap (ID) | Datatyp | Beskrivning | Exempel på ett returnerat värde |
---|---|---|---|
Kategori | Sträng | Åtgärdsaktivitetens kategori (programvaru-/säkerhetskonfiguration) | Programvara |
completerEmail | Sträng | Om reparationsaktiviteten slutfördes manuellt av någon innehåller den här kolumnen deras e-post | Null |
completerId | Sträng | Om reparationsaktiviteten slutfördes manuellt av någon innehåller den här kolumnen deras objekt-ID | Null |
completionMethod | Sträng | En åtgärdsaktivitet kan slutföras "automatiskt" (om alla enheter korrigeras) eller "manuellt" av en person som väljer "markera som slutförd" | Automatisk |
createdOn | Datetime | Tiden då den här reparationsaktiviteten skapades | 2021-01-12T18:54:11.5499478Z |
Beskrivning | Sträng | Beskrivning av den här reparationsaktiviteten | Uppdatera Microsoft Silverlight till en senare version för att minska kända sårbarheter som påverkar dina enheter. |
dueOn | Datetime | Förfallodatum som skaparen har angett för den här reparationsaktiviteten | 2021-01-13T00:00:00Z |
fixedDevices | . | Antalet enheter som har åtgärdats | 2 |
ID | Sträng | ID för den här reparationsaktiviteten | 097d9735-5479-4899-b1b7-77398899df92 |
nameId | Sträng | Relaterat produktnamn | Microsoft Silverlight |
Prioritet | Sträng | Prioritera den skapare som angetts för den här reparationsaktiviteten (High\Medium\Low) | Högsta |
Produktionen | Sträng | Relaterat produkt-ID | microsoft-_-silverlight |
productivityImpactRemediationType | Sträng | Några konfigurationsändringar kan bara begäras för enheter som inte påverkar användarna. Det här värdet anger valet mellan "alla exponerade enheter" eller "endast enheter utan användarpåverkan". | AllExposedAssets |
rbacGroupNames | Sträng | Relaterade enhetsgruppsnamn | [ "Windows-servrar", "Windows 11", "Windows 10" ] |
recommendedProgram | Sträng | Rekommenderat program att uppgradera till | Null |
recommendedVendor | Sträng | Rekommenderad leverantör att uppgradera till | Null |
recommendedVersion | Sträng | Rekommenderad version att uppdatera/uppgradera till | Null |
relatedComponent | Sträng | Relaterad komponent i den här reparationsaktiviteten (liknar den relaterade komponenten för en säkerhetsrekommendation) | Microsoft Silverlight |
requesterEmail | Sträng | Skaparens e-postadress | globaladmin@UserName.contoso.com |
requesterId | Sträng | Skaparobjekt-ID | r647211f-2e16-43f2-a480-16ar3a2a796r |
requesterNotes | Sträng | Anteckningarna (fritext) som skaparen lade till för den här reparationsaktiviteten | Null |
Scid | Sträng | SCID för den relaterade säkerhetsrekommendationsen | Null |
Status | Sträng | Status för åtgärdsaktivitet (aktiv/slutförd) | Aktiv |
statusLastModifiedOn | Datetime | Datum då statusfältet uppdaterades | 2021-01-12T18:54:11.5499487Z |
targetDevices | Lång | Antal exponerade enheter som den här reparationen gäller för | 43 |
Rubrik | Sträng | Rubrik för den här reparationsaktiviteten | Uppdatera Microsoft Silverlight |
Typ | Sträng | Reparationstyp | Update |
vendorId | Sträng | Relaterat leverantörsnamn | Microsoft |
Exempel
Exempel på begäran
GET https://api.securitycenter.windows.com/api/remediationtasks/
Svarsexempel
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks",
"value": [
{
"id": "03942ef5-aewb-4w6e-b555-d6a97013844w",
"title": "Update Microsoft Silverlight",
"createdOn": "2021-02-10T13:20:36.4718166Z",
"requesterId": "65548a1d-ef00-4a7a-8d19-1b967b5c36f4",
"requesterEmail": "user1@contoso.com",
"status": "Active",
"statusLastModifiedOn": "2021-02-10T13:20:36.4719698Z",
"description": "Update Silverlight to a later version to mitigate 55 known vulnerabilities affecting your devices. Doing so can help lessen the security risk to your organization due to versions which have reached their end-of-support.",
"relatedComponent": "Microsoft Silverlight",
"targetDevices": 18511,
"rbacGroupNames": [
"UnassignedGroup",
"hhh"
],
"fixedDevices": 2866,
"requesterNotes": "test",
"dueOn": "2021-02-11T00:00:00Z",
"category": "Software",
"productivityImpactRemediationType": null,
"priority": "Medium",
"completionMethod": null,
"completerId": null,
"completerEmail": null,
"scid": null,
"type": "Update",
"productId": "microsoft-_-silverlight",
"vendorId": "microsoft",
"nameId": "silverlight",
"recommendedVersion": null,
"recommendedVendor": null,
"recommendedProgram": null
}
]
}
Se även
- Reparationsmetoder och egenskaper
- Få en åtgärdsaktivitet med ID
- Lista exponerade enheter av en åtgärdsaktivitet
- Hantering av hot och säkerhetsrisker för Microsoft Defender
- Sårbarheter i din organisation
Tips
Vill du veta mer? Engage med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender för Endpoint Tech Community.
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för