Teilen über

Erhalten einer Korrekturaktivität nach ID

  • Artikel

Gilt für:

Möchten Sie Microsoft Defender für Endpunkt ausprobieren? Registrieren Sie sich für eine kostenlose Testversion.

Möchten Sie Microsoft Defender Vulnerability Management erleben? Erfahren Sie mehr darüber, wie Sie sich für die Microsoft Defender Vulnerability Management öffentliche Vorschauversion registrieren können.

Wichtig

Einige Informationen in diesem Artikel beziehen sich auf ein vorab veröffentlichtes Produkt, das vor der kommerziellen Veröffentlichung möglicherweise erheblich geändert wird. Microsoft übernimmt in Bezug auf die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklich noch konkludent.

Hinweis

Wenn Sie ein US Government-Kunde sind, verwenden Sie bitte die URIs, die in Microsoft Defender for Endpoint für US Government-Kunden aufgeführt sind.

Tipp

Um die Leistung zu verbessern, können Sie den Server näher an Ihrem geografischen Standort verwenden:

  • 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-Beschreibung

Gibt Informationen für die angegebene Wartungsaktivität zurück. Zeigt die gleichen Spalten wie Get all remediation activity" (Alle Wartungsaktivität abrufen) an, gibt jedoch nur Ergebnisse für die angegebene Wartungsaktivität zurück.

Erfahren Sie mehr über Wartungsaktivitäten.

Auflisten einer angegebenen Wartungsaktivität für (ID)

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

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, einschließlich der Auswahl von Berechtigungen, finden Sie unter Verwenden Microsoft Defender for Endpoint APIs.

Berechtigungstyp Berechtigung Anzeigename der Berechtigung
App RemediationTasks.Read.All Informationen zur Bedrohungs- und Sicherheitsrisikoverwaltung lesen
Delegiert (Geschäfts-, Schul- oder Unikonto) RemediationTask.Read.Read Informationen zur Bedrohungs- und Sicherheitsrisikoverwaltung lesen

Eigenschaften

Eigenschaft (ID) Datentyp Beschreibung Beispiel für einen zurückgegebenen Wert
Kategorie Zeichenfolge Kategorie der Wartungsaktivität (Software-/Sicherheitskonfiguration) Software
completerEmail String Wenn die Wartungsaktivität von jemanden manuell abgeschlossen wurde, enthält diese Spalte die E-Mail-Adresse. Null
completerId String Wenn die Wartungsaktivität von jemandem manuell abgeschlossen wurde, enthält diese Spalte deren Objekt-ID. Null
completionMethod String Eine Wartungsaktivität kann "automatisch" (wenn alle Geräte gepatcht sind) oder "manuell" von einer Person abgeschlossen werden, die "Als abgeschlossen markieren" auswählt. Automatisch
createdOn DateTime Zeitpunkt, zu dem diese Wartungsaktivität erstellt wurde 2021-01-12T18:54:11.5499478Z
Beschreibung String Beschreibung dieser Wartungsaktivität Aktualisieren Sie Microsoft Silverlight auf eine höhere Version, um bekannte Sicherheitsrisiken zu beheben, die Sich auf Ihre Geräte auswirken.
dueOn DateTime Fälligkeitsdatum, das der Ersteller für diese Wartungsaktivität festgelegt hat 2021-01-13T00:00:00Z
fixedDevices Die Anzahl der Geräte, die behoben wurden 2
ID String ID dieser Wartungsaktivität 097d9735-5479-4899-b1b7-77398899df92
nameId String Zugehöriger Produktname Microsoft Silverlight
Priorität String Priorität, die der Ersteller für diese Wartungsaktivität festgelegt hat (Hoch\Mittel\Niedrig) Hoch
Productid String Zugehörige Produkt-ID microsoft-_-silverlight
productivityImpactRemediationType String Einige Konfigurationsänderungen können nur für Geräte angefordert werden, die sich nicht auf Benutzer auswirken. Dieser Wert gibt die Auswahl zwischen "alle verfügbar gemachten Geräte" oder "nur Geräte ohne Auswirkungen auf den Benutzer" an. AllExposedAssets
rbacGroupNames String Zugehörige Gerätegruppennamen [ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram String Empfohlenes Programm für das Upgrade auf Null
recommendedVendor String Empfohlener Anbieter für ein Upgrade auf Null
recommendedVersion String Empfohlene Version, auf die aktualisiert/aktualisiert werden soll Null
RelatedComponent String Verwandte Komponente dieser Wartungsaktivität (ähnlich der zugehörigen Komponente für eine Sicherheitsempfehlung) Microsoft Silverlight
requesterEmail String E-Mail-Adresse des Erstellers globaladmin@UserName.contoso.com
requesterId String Creator-Objekt-ID r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes String Die Notizen (Freitext), die der Ersteller für diese Wartungsaktivität hinzugefügt hat Null
Scid String SCID der zugehörigen Sicherheitsempfehlung Null
Status String Wartungsaktivität status (Aktiv/Abgeschlossen) Aktiv
statusLastModifiedOn DateTime Datum, an dem das status Feld aktualisiert wurde 2021-01-12T18:54:11.5499487Z
targetDevices Long Anzahl der verfügbar gemachten Geräte, für die diese Korrektur gilt 43
Titel Zeichenfolge Titel dieser Wartungsaktivität Microsoft Silverlight
Typ String Wartungstyp Aktualisieren
Vendorid String Zugehöriger Anbietername Microsoft

Beispiel

Anforderungsbeispiel

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

Anforderungsbeispiel

{
    "@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
}

Siehe auch

Tipp

Möchten Sie mehr erfahren? Engage mit der Microsoft-Sicherheitscommunity in unserer Tech Community: Microsoft Defender for Endpoint Tech Community.