Eén herstelactiviteit krijgen op id

Artikel
05/03/2024

Van toepassing op:

Wilt u Microsoft Defender voor Eindpunt ervaren? Meld u aan voor een gratis proefversie.

Wilt u microsoft Defender Vulnerability Management ervaren? Meer informatie over hoe u zich kunt registreren voor de openbare preview-proefversie van Microsoft Defender Vulnerability Management.

Belangrijk

Sommige informatie in dit artikel heeft betrekking op een vooraf uitgebracht product dat aanzienlijk kan worden gewijzigd voordat het commercieel wordt uitgebracht. Microsoft geeft geen garanties, expliciet of impliciet, met betrekking tot de informatie die hier wordt verstrekt.

Opmerking

Als u een klant van de Amerikaanse overheid bent, gebruikt u de URI's die worden vermeld in Microsoft Defender voor Eindpunt voor klanten van de Amerikaanse overheid.

Tip

Voor betere prestaties kunt u de server dichter bij uw geografische locatie gebruiken:

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-beschrijving

Retourneert informatie voor de opgegeven herstelactiviteit. Geeft dezelfde kolommen weer als Alle herstelactiviteit ophalen, maar retourneert alleen resultaten voor de opgegeven herstelactiviteit.

Meer informatie over herstelactiviteiten.

Een opgegeven herstelactiviteit weergeven voor (id)

URL: GET: /api/remediationTasks/{id}

Machtigingen

Een van de volgende machtigingen is vereist om deze API aan te roepen. Zie Microsoft Defender voor Eindpunt-API's gebruiken voor meer informatie, waaronder het kiezen van machtigingen.

Machtigingstype	Machtiging	Weergavenaam van machtiging
Toepassing	RemediationTasks.Read.All	'Informatie over beveiligingsproblemen in bedreigings- en beveiligingsbeheer lezen'
Gedelegeerd (werk- of schoolaccount)	RemediationTask.Read.Read	'Informatie over beveiligingsproblemen in bedreigings- en beveiligingsbeheer lezen'

Eigenschappen

Eigenschap (id)	Gegevenstype:	Beschrijving	Voorbeeld van een geretourneerde waarde
Categorie	Tekenreeks	Categorie van de herstelactiviteit (software-/beveiligingsconfiguratie)	Software
completerEmail	Tekenreeks	Als de herstelactiviteit handmatig is voltooid door iemand, bevat deze kolom zijn/haar e-mailadres	Nul
completerId	Tekenreeks	Als de herstelactiviteit handmatig is voltooid door iemand, bevat deze kolom de object-id	Nul
completionMethod	Tekenreeks	Een herstelactiviteit kan 'automatisch' worden voltooid (als alle apparaten zijn gepatcht) of 'handmatig' door een persoon die 'markeren als voltooid' selecteert	Automatisch
createdOn	DateTime	Tijdstip waarop deze herstelactiviteit is gemaakt	2021-01-12T18:54:11.5499478Z
Beschrijving	Tekenreeks	Beschrijving van deze herstelactiviteit	Werk Microsoft Silverlight bij naar een latere versie om bekende beveiligingsproblemen op uw apparaten te beperken.
dueOn	DateTime	Einddatum die de maker heeft ingesteld voor deze herstelactiviteit	2021-01-13T00:00:00Z
fixedDevices		Het aantal apparaten dat is opgelost	2
ID	Tekenreeks	Id van deze herstelactiviteit	097d9735-5479-4899-b1b7-77398899df92
nameId	Tekenreeks	Gerelateerde productnaam	Microsoft Silverlight
Priority	Tekenreeks	Prioriteit van de maker die is ingesteld voor deze herstelactiviteit (Hoog\Gemiddeld\Laag)	Hoog
Productid	Tekenreeks	Gerelateerde product-id	microsoft-_-silverlight
productivityImpactRemediationType	Tekenreeks	Enkele configuratiewijzigingen kunnen alleen worden aangevraagd voor apparaten die geen invloed hebben op gebruikers. Deze waarde geeft de selectie aan tussen 'alle blootgestelde apparaten' of 'alleen apparaten zonder gebruikersimpact'.	AllExposedAssets
rbacGroupNames	Tekenreeks	Gerelateerde namen van apparaatgroepen	[ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram	Tekenreeks	Aanbevolen programma om te upgraden naar	Nul
recommendedVendor	Tekenreeks	Aanbevolen leverancier om te upgraden naar	Nul
recommendedVersion	Tekenreeks	Aanbevolen versie om bij te werken/upgraden naar	Nul
relatedComponent	Tekenreeks	Gerelateerd onderdeel van deze herstelactiviteit (vergelijkbaar met het gerelateerde onderdeel voor een beveiligingsaanbeveling)	Microsoft Silverlight
requesterEmail	Tekenreeks	E-mailadres van maker	globaladmin@UserName.contoso.com
requesterId	Tekenreeks	Object-id van maker	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	Tekenreeks	De notities (vrije tekst) die de maker heeft toegevoegd voor deze herstelactiviteit	Nul
Scid	Tekenreeks	SCID van de gerelateerde beveiligingsaan aanbeveling	Nul
Status	Tekenreeks	Status van herstelactiviteit (actief/voltooid)	Actief
statusLastModifiedOn	DateTime	Datum waarop het statusveld is bijgewerkt	2021-01-12T18:54:11.5499487Z
targetDevices	Lang	Aantal blootgestelde apparaten waarop dit herstel van toepassing is	43
Titel	Tekenreeks	Titel van deze herstelactiviteit	Microsoft Silverlight
Type	Tekenreeks	Type herstel	Update
vendorId	Tekenreeks	Naam van gerelateerde leverancier	Microsoft

Voorbeeld

Voorbeeld van aanvraag

GET https://api.securitycenter.windows.com/api/remediationtasks/03942ef5-aecb-4c6e-b555-d6a97013844c

Antwoordvoorbeeld

{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks/$entity",
    "id": "03942ef5-aecb-4c6e-b555-d6a97013844c",
    "title": "Update Microsoft Silverlight",
    "createdOn": "2021-02-10T13:20:36.4718166Z",
    "requesterId": "65548a1d-efo0-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
}

Zie ook

Tip

Wil je meer weten? Neem contact op met de Microsoft Security-community in onze Tech Community: Microsoft Defender for Endpoint Tech Community.

Delen via