Megosztás a következőn keresztül:

Az összes szervizelési művelet listázása

  • Cikk

Érintett szolgáltatás:

Szeretné megismerni a Végponthoz készült Microsoft Defendert? Regisztráljon az ingyenes próbaverzióra.

Szeretné megtapasztalni a Microsoft Defender biztonságirés-kezelését? További információ arról, hogyan regisztrálhat a Microsoft Defender biztonságirés-kezelés nyilvános előzetes verziójára.

Fontos

A cikkben található információk egy része egy előzetesen kiadott termékre vonatkozik, amely a kereskedelmi forgalomba kerülés előtt lényegesen módosulhat. A Microsoft nem vállal kifejezett vagy hallgatólagos szavatosságot az itt megadott információkra vonatkozóan.

Megjegyzés:

Ha Ön az USA kormányzati szerveinek ügyfele, használja az USA kormányzati ügyfeleinek készült Végponthoz készült Microsoft Defenderben felsorolt URI-kat.

Tipp

A jobb teljesítmény érdekében a földrajzi helyhez közelebbi kiszolgálót használhat:

  • 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-leírás

Az összes szervizelési tevékenység adatait adja vissza.

További információ a szervizelési tevékenységekről.

URL-cím: GET: /api/remediationTasks
Támogatja az OData V4-lekérdezéseket.
OData által támogatott operátorok:
$filter on: createdon és status properties.
$top legfeljebb 10 000 értékkel.
$skip.
Példákat az OData-lekérdezések a Végponthoz készült Microsoft Defenderrel című témakörben talál.

Engedélyek

Az API meghívásához az alábbi engedélyek egyikére van szükség. További információ, többek között az engedélyek kiválasztása: Végponthoz készült Microsoft Defender API-k használata.

Engedély típusa Engedély Engedély megjelenítendő neve
Alkalmazás RemediationTasks.Read.All "Veszélyforrás- és biztonságirés-kezelési biztonságirés-információk olvasása"
Delegált (munkahelyi vagy iskolai fiók) RemediationTask.Read "Veszélyforrás- és biztonságirés-kezelési biztonságirés-információk olvasása"

Tulajdonságok

Tulajdonság (azonosító) Adattípus Leírás Példa visszaadott értékre
Kategória Karakterlánc A szervizelési tevékenység kategóriája (szoftver/biztonsági konfiguráció) Szoftver
completerEmail Karakterlánc Ha a szervizelési tevékenységet valaki manuálisan hajtotta végre, ez az oszlop tartalmazza az e-mail-címét Nulla
completerId Karakterlánc Ha a szervizelési tevékenységet valaki manuálisan hajtotta végre, ez az oszlop tartalmazza az objektumazonosítóját Nulla
completionMethod Karakterlánc A szervizelési tevékenységet "automatikusan" végezheti el (ha az összes eszköz javítva van), vagy "manuálisan" egy olyan személy, aki a "megjelölés befejezettként" lehetőséget választja Automatikus
createdOn DateTime A szervizelési tevékenység létrehozásának időpontja 2021-01-12T18:54:11.5499478Z
Leírás Karakterlánc A szervizelési tevékenység leírása Frissítse a Microsoft Silverlightot egy újabb verzióra, hogy enyhítse az eszközöket érintő ismert biztonsági réseket.
dueOn DateTime A szervizelési tevékenység létrehozója által beállított határidő 2021-01-13T00:00:00Z
fixedDevices . A kijavított eszközök száma 2
Azonosító Karakterlánc A szervizelési tevékenység azonosítója 097d9735-5479-4899-b1b7-77398899df92
nameId Karakterlánc Kapcsolódó terméknév Microsoft Silverlight
Elsőbbség Karakterlánc A létrehozó által beállított prioritás ehhez a szervizelési tevékenységhez (Magas\Közepes\Alacsony) Magas
Termelés Karakterlánc Kapcsolódó termékazonosító microsoft-_-silverlight
productivityImpactRemediationType Karakterlánc Néhány konfigurációs módosítást csak olyan eszközökön lehet kérelmezni, amelyek nincsenek hatással a felhasználókra. Ez az érték az "összes közzétett eszköz" vagy "csak a felhasználói hatással nem rendelkező eszközök" közötti választást jelzi. AllExposedAssets
rbacGroupNames Karakterlánc Kapcsolódó eszközcsoportnevek [ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram Karakterlánc Javasolt program a frissítéshez Nulla
recommendedVendor Karakterlánc Ajánlott szállító, akire frissíteni szeretne Nulla
recommendedVersion Karakterlánc Javasolt verzió a frissítéshez/frissítéshez Nulla
relatedComponent Karakterlánc A szervizelési tevékenység kapcsolódó összetevője (hasonló a biztonsági javaslathoz kapcsolódó összetevőhöz) Microsoft Silverlight
requesterEmail Karakterlánc Létrehozó e-mail-címe globaladmin@UserName.contoso.com
requesterId Karakterlánc Létrehozó objektumazonosítója r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes Karakterlánc A létrehozó által a szervizelési tevékenységhez hozzáadott jegyzetek (szabad szöveg) Nulla
Scid Karakterlánc A kapcsolódó biztonsági javaslat SCID-azonosítója Nulla
Állapot Karakterlánc Szervizelési tevékenység állapota (Aktív/Befejezve) Aktív
statusLastModifiedOn DateTime Az állapotmező frissítésének dátuma 2021-01-12T18:54:11.5499487Z
targetDevices Hosszú Azon közzétett eszközök száma, amelyekre ez a szervizelés alkalmazható 43
Title Karakterlánc A szervizelési tevékenység címe A Microsoft Silverlight frissítése
Típus Karakterlánc Szervizelési típus Frissítés
vendorId Karakterlánc Kapcsolódó szállító neve Microsoft

Példa

Példa kérésre

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

Példa válaszra

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

Lásd még

Tipp

Szeretne többet megtudni? Vegye fel a kapcsolatot a Microsoft Security közösségével a technikai közösségünkben: Microsoft Defender for Endpoint Tech Community.