Teilen über

Auflisten aller Korrekturaktivitäten

  • 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-Sicherheitsrisikomanagement erleben? Erfahren Sie mehr darüber, wie Sie sich für die öffentliche Vorschauversion von Microsoft Defender Vulnerability Management 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 die URIs, die unter Microsoft Defender für Endpunkt 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
  • ina.api.security.microsoft.com

API-Beschreibung

Gibt Informationen zu allen Wartungsaktivitäten zurück.

Erfahren Sie mehr über Wartungsaktivitäten.

URL: GET: /api/remediationTasks
Unterstützt OData V4-Abfragen.
OData-unterstützte Operatoren:
$filter on: createdon und status eigenschaften.
$top mit einem maximalen Wert von 10.000.
$skip.
Beispiele finden Sie unter OData-Abfragen mit Microsoft Defender für Endpunkt.

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 von Microsoft Defender für Endpunkt-APIs.

Berechtigungstyp Berechtigung Anzeigename der Berechtigung
App RemediationTasks.Read.All Informationen zur Bedrohungs- und Sicherheitsrisikoverwaltung lesen
Delegiert (Geschäfts-, Schul- oder Unikonto) RemediationTask.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 Zeichenfolge Wenn die Wartungsaktivität von jemanden manuell abgeschlossen wurde, enthält diese Spalte die E-Mail-Adresse. Null
completerId Zeichenfolge Wenn die Wartungsaktivität von jemandem manuell abgeschlossen wurde, enthält diese Spalte deren Objekt-ID. Null
completionMethod Zeichenfolge 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 Zeichenfolge 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 Zeichenfolge ID dieser Wartungsaktivität 097d9735-5479-4899-b1b7-77398899df92
nameId Zeichenfolge Zugehöriger Produktname Microsoft Silverlight
Priorität Zeichenfolge Priorität, die der Ersteller für diese Wartungsaktivität festgelegt hat (Hoch\Mittel\Niedrig) Hoch
Productid Zeichenfolge Zugehörige Produkt-ID microsoft-_-silverlight
productivityImpactRemediationType Zeichenfolge 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 Zeichenfolge Zugehörige Gerätegruppennamen [ "Windows Server", "Windows 11", "Windows 10" ]
recommendedProgram Zeichenfolge Empfohlenes Programm für das Upgrade auf Null
recommendedVendor Zeichenfolge Empfohlener Anbieter für ein Upgrade auf Null
recommendedVersion Zeichenfolge Empfohlene Version, auf die aktualisiert/aktualisiert werden soll Null
RelatedComponent Zeichenfolge Verwandte Komponente dieser Wartungsaktivität (ähnlich der zugehörigen Komponente für eine Sicherheitsempfehlung) Microsoft Silverlight
requesterEmail Zeichenfolge E-Mail-Adresse des Erstellers globaladmin@UserName.contoso.com
requesterId Zeichenfolge Creator-Objekt-ID r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes Zeichenfolge Die Notizen (Freitext), die der Ersteller für diese Wartungsaktivität hinzugefügt hat Null
Scid Zeichenfolge SCID der zugehörigen Sicherheitsempfehlung Null
Status Zeichenfolge Wartungsaktivitätsstatus (Aktiv/Abgeschlossen) Aktiv
statusLastModifiedOn DateTime Datum, an dem das Statusfeld 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 aktualisieren
Typ String Wartungstyp Aktualisieren
vendorId Zeichenfolge Zugehöriger Anbietername Microsoft

Beispiel

Anforderungsbeispiel

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

Anforderungsbeispiel

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

Siehe auch

Tipp

Möchten Sie mehr erfahren? Wenden Sie sich an die Microsoft-Sicherheitscommunity in unserer Tech Community: Microsoft Defender for Endpoint Tech Community.