Egy szervizelési művelet beolvasása azonosító alapján

Cikk
08/14/2024

É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

A megadott szervizelési tevékenység adatait adja vissza. Ugyanazokat az oszlopokat jeleníti meg, mint az Összes szervizelési tevékenység lekérése", de csak a megadott szervizelési tevékenység eredményeit adja vissza.

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

A megadott szervizelési tevékenység listázása a következőhöz: (ID)

URL-cím: GET: /api/remediationTasks/{id}

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.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	Microsoft Silverlight
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/03942ef5-aecb-4c6e-b555-d6a97013844c

Példa válaszra

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

Lásd még