Luetteloi kaikki korjaustoiminnot

Artikkeli
08/14/2024

Koskee seuraavia:

Haluatko kokea Microsoft Defender for Endpointin? Rekisteröidy ilmaiseen kokeiluversioon..

Haluatko kokea Microsoft Defenderin haavoittuvuuden hallinnan? Lue lisätietoja siitä, miten voit rekisteröityä Microsoft Defenderin haavoittuvuuden hallinnan julkisen esikatselun kokeiluversioon.

Tärkeää

Jotkin tämän artikkelin tiedot liittyvät tuotteen ennakkojulkaisuversioon, jota voidaan muuttaa huomattavasti ennen kaupallista julkaisua. Microsoft ei anna mitään takuita tässä annettujen tietojen suhteen.

Huomautus

Jos olet Yhdysvaltain valtionhallinnon asiakas, käytä Microsoft Defender for Endpoint for Us Government -asiakkaille lueteltuja URI-osoitteita.

Vihje

Suorituskyvyn parantamiseksi voit käyttää palvelinta lähempänä maantieteellistä sijaintiasi:

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

Ohjelmointirajapinnan kuvaus

Palauttaa tietoja kaikista korjaustoiminnoista.

Lisätietoja korjaustoimista.

URL: GET: /api/remediationTasks
Tukee OData V4 -kyselyitä.
Tuetut OData-operaattorit:
$filter päivänä: createdon ja status ominaisuudet.
$top suurin arvo on 10 000.
$skip.
Katso esimerkkejä OData-kyselyistä Microsoft Defender for Endpointin avulla.

Käyttöoikeudet

Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Jos haluat lisätietoja, mukaan lukien käyttöoikeuksien valitsemisesta, katso lisätietoja kohdasta Microsoft Defenderin käyttö päätepisteen ohjelmointirajapinnoille.

Käyttöoikeustyyppi	Lupa	Käyttöoikeuden näyttönimi
Sovellus	RemediationTasks.Read.All	Lue uhkien ja haavoittuvuuden hallinnan haavoittuvuustiedot
Delegoitu (työpaikan tai oppilaitoksen tili)	RemediationTask.Read	Lue uhkien ja haavoittuvuuden hallinnan haavoittuvuustiedot

Ominaisuudet

Ominaisuus (tunnus)	Tietotyyppi	Kuvaus	Esimerkki palautetun arvon
Luokka	Merkkijono	Korjaustoiminnon luokka (Software/Security configuration)	Ohjelmisto
completerEmail	Merkkijono	Jos joku suoritti korjaustoiminnon manuaalisesti, tämä sarake sisältää hänen sähköpostinsa	Nolla
completerId	Merkkijono	Jos joku suoritti korjaustoiminnon manuaalisesti, tämä sarake sisältää hänen objektitunnuksensa	Nolla
completionMethod	Merkkijono	Korjausaktiviteetin voi suorittaa "automaattisesti", jos kaikki laitteet on paikattu, tai "manuaalisesti" henkilö, joka valitsee "merkitse valmiiksi"	Automaattinen
createdOn	Päivämäärä ja aika	Aika, jolloin tämä korjaustoiminto luotiin	2021-01-12T18:54:11.5499478Z
Kuvaus	Merkkijono	Korjaustoiminnon kuvaus	Päivitä Microsoft Silverlight uudempaan versioon, jotta voit lieventää laitteisiin vaikuttavia tunnettuja haavoittuvuuksia.
dueOn	Päivämäärä ja aika	Määräpäivä, jonka tekijä on määrittänyt tälle korjaustoiminnolle	2021-01-13T00:00:00Z
fixedDevices	.	Korjattujen laitteiden määrä	2
ID	Merkkijono	Tämän korjaustoiminnon tunnus	097d9735-5479-4899-b1b7-77398899df92
nameId	Merkkijono	Aiheeseen liittyvän tuotteen nimi	Microsoft Silverlight
Prioriteetti	Merkkijono	Tekijän tälle korjaustoiminnalle asettama prioriteetti (Suuri\Normaali\Pieni)	Korkea
Productid	Merkkijono	Liittyvä tuotetunnus	microsoft-_-silverlight
productivityImpactRemediationType	Merkkijono	Joitakin määritysmuutoksia voidaan pyytää vain laitteissa, jotka eivät vaikuta käyttäjiin. Tämä arvo ilmaisee valinnan "kaikkien näkyvien laitteiden" tai "vain niiden laitteiden välillä, joilla ei ole vaikutusta käyttäjään".	KaikkiexposedAssets
rbacGroupNames	Merkkijono	Liittyvien laiteryhmien nimet	[ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram	Merkkijono	Suositeltu ohjelma, johon päivitetään	Nolla
recommendedVendor	Merkkijono	Suositeltu toimittaja, johon päivitetään	Nolla
recommendedVersion	Merkkijono	Suositeltu versio, johon päivitetään tai johon päivitetään	Nolla
liittyvä osa	Merkkijono	Tämän korjaustoiminnon liittyvä osa (samankaltainen kuin tietoturvasuosituksen liittyvä osa)	Microsoft Silverlight
requesterEmail	Merkkijono	Tekijän sähköpostiosoite	globaladmin@UserName.contoso.com
requesterId	Merkkijono	Tekijän objektitunnus	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	Merkkijono	Muistiinpanot (vapaa teksti), jotka tekijä on lisännyt tähän korjaustoimintoon	Nolla
Scid	Merkkijono	Liittyvän suojaussuosituksen SCID	Nolla
Tila	Merkkijono	Korjaustoiminnon tila (aktiivinen/valmis)	Aktiivinen
statusLastModifiedOn	Päivämäärä ja aika	Päivämäärä, jolloin tilakenttä päivitettiin	2021-01-12T18:54:11.5499487Z
targetDevices	Pitkä	Niiden paljaiden laitteiden määrä, joihin tämä korjaus koskee	43
Title	Merkkijono	Tämän korjaustoiminnon otsikko	Päivitä Microsoft Silverlight
Kirjoita	Merkkijono	Korjaustyyppi	Päivitä
vendorId	Merkkijono	Liittyvän toimittajan nimi	Microsoft

Esimerkki

Esimerkkipyyntö

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

Vastausesimerkki

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

Tutustu myös seuraaviin ohjeartikkeleihin: