Angiv alle afhjælpningsaktiviteter

Artikel
08/14/2024

Gælder for:

Vil du opleve Microsoft Defender for Endpoint? Tilmeld dig en gratis prøveversion.

Vil du gerne opleve Microsoft Defender Vulnerability Management? Få mere at vide om, hvordan du kan tilmelde dig prøveversionen af Den offentlige prøveversion af Microsoft Defender Vulnerability Management.

Vigtigt!

Nogle oplysninger i denne artikel er relateret til et produkt, der er udgivet på forhånd, og som kan blive ændret væsentligt, før det udgives kommercielt. Microsoft giver ingen garantier, udtrykt eller stiltiende, med hensyn til de oplysninger, der er angivet her.

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

Returnerer oplysninger om alle afhjælpningsaktiviteter.

Få mere at vide om afhjælpningsaktiviteter.

URL-adresse: GET: /api/remediationTasks
Understøtter OData V4-forespørgsler.
OData-understøttede operatorer:
$filter på: createdon og status egenskaber.
$top med en maksimumværdi på 10.000.
$skip.
Se eksempler på OData-forespørgsler med Microsoft Defender for Endpoint.

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 for Endpoint API'er for at få flere oplysninger.

Tilladelsestype	Tilladelse	Vist navn for tilladelse
Program	RemediationTasks.Read.All	'Læs oplysninger om sårbarheder i forbindelse med trussels- og sårbarhedsstyring'
Uddelegeret (arbejds- eller skolekonto)	RemediationTask.Read	'Læs oplysninger om sårbarheder i forbindelse med trussels- og sårbarhedsstyring'

Egenskaber

Egenskab (id)	Datatype	Beskrivelse	Eksempel på en returneret værdi
Kategori	String	Kategori for afhjælpningsaktiviteten (software-/sikkerhedskonfiguration)	Software
completerEmail	String	Hvis afhjælpningsaktiviteten blev udført manuelt af en person, indeholder denne kolonne deres mail	Nul
completerId	String	Hvis afhjælpningsaktiviteten blev udført manuelt af en person, indeholder denne kolonne deres objekt-id	Nul
completionMethod	String	En afhjælpningsaktivitet kan fuldføres "automatisk" (hvis alle enhederne er repareret) eller "manuelt" af en person, der vælger "Markér som fuldført"	Automatisk
oprettet til	DateTime	Det tidspunkt, hvor denne afhjælpningsaktivitet blev oprettet	2021-01-12T18:54:11.5499478Z
Beskrivelse	String	Beskrivelse af denne afhjælpningsaktivitet	Opdater Microsoft Silverlight til en nyere version for at afhjælpe kendte sikkerhedsrisici, der påvirker dine enheder.
forfalder til	DateTime	Forfaldsdato, som forfatteren har angivet for denne afhjælpningsaktivitet	2021-01-13T00:00:00Z
fixedDevices	.	Antallet af enheder, der er blevet rettet	2
ID	String	Id for denne afhjælpningsaktivitet	097d9735-5479-4899-b1b7-77398899df92
nameId	String	Relateret produktnavn	Microsoft Silverlight
Prioritet	String	Prioritet, som opretteren har angivet for denne afhjælpningsaktivitet (Høj\Mellem\Lav)	Høj
Instruktion	String	Relateret produkt-id	microsoft-_-silverlight
produktivitetImpactRemediationType	String	Der kan kun anmodes om nogle få konfigurationsændringer for enheder, der ikke påvirker brugerne. Denne værdi angiver valget mellem "alle eksponerede enheder" eller "kun enheder uden brugerpåvirkning".	AlleEksponeredeassets
rbacGroupNames	String	Relaterede enhedsgruppenavne	[ "Windows Servers", "Windows 11", "Windows 10" ]
anbefalet program	String	Anbefalet program til opgradering til	Nul
recommendedVendor	String	Anbefalet leverandør, der skal opgraderes til	Nul
recommendedVersion	String	Anbefalet version til opdatering/opgradering til	Nul
relatedComponent	String	Relateret komponent til denne afhjælpningsaktivitet (svarer til den relaterede komponent til en sikkerhedsanbefaling)	Microsoft Silverlight
requesterEmail	String	Opretterens mailadresse	globaladmin@UserName.contoso.com
requesterId	String	Opretterobjekt-id	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	String	De noter (fri tekst), som forfatteren har tilføjet til denne afhjælpningsaktivitet	Nul
Scid	String	SCID for den relaterede sikkerhedsanbefaling	Nul
Status	String	Status for afhjælpningsaktivitet (aktiv/fuldført)	Aktiv
statusLastModifiedOn	DateTime	Dato for opdatering af statusfeltet	2021-01-12T18:54:11.5499487Z
targetDevices	Lang	Antal eksponerede enheder, som denne afhjælpning gælder for	43
Titel	String	Titlen på denne afhjælpningsaktivitet	Opdater Microsoft Silverlight
Type	String	Afhjælpningstype	Opdater
vendorId	String	Navn på relateret leverandør	Microsoft

Eksempel

Eksempel på anmodning

GET https://api.securitycenter.windows.com/api/remediationtasks/

Svareksempel

{
    "@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 også

Tip

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

Del via