Elencare tutte le attività correttive
Si applica a:
- Microsoft Defender per endpoint Piano 1
- Microsoft Defender per endpoint Piano 2
- Gestione delle vulnerabilità di Microsoft Defender
- Microsoft Defender XDR
Se si desidera provare Microsoft Defender per endpoint, Iscriversi per una versione di valutazione gratuita.
Si vuole provare Gestione vulnerabilità di Microsoft Defender? Altre informazioni su come iscriversi alla versione di valutazione dell'anteprima pubblica di Microsoft Defender Vulnerability Management.
Importante
Alcune informazioni in questo articolo fanno riferimento alle caratteristiche di un prodotto prima del rilascio, che possono essere modificate sostanzialmente prima della distribuzione al pubblico. Microsoft non fornisce alcuna garanzia, esplicita o implicita, in relazione alle informazioni contenute in questo documento.
Nota
Se si è un cliente del governo degli Stati Uniti, usare gli URI elencati in Microsoft Defender per endpoint per i clienti del governo degli Stati Uniti.
Consiglio
Per ottenere prestazioni migliori, è possibile usare il server più vicino alla posizione geografica:
- 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
Descrizione DELL'API
Restituisce informazioni su tutte le attività di correzione.
Altre informazioni sulle attività di correzione.
URL: GET: /api/remediationTasks
Supporta le query OData V4.
Operatori supportati da OData:
$filter
on: createdon
e status
proprietà.
$top
con un valore massimo di 10.000.
$skip
.
Vedere gli esempi nelle query OData con Microsoft Defender per endpoint.
Autorizzazioni
Per chiamare questa API è necessaria una delle autorizzazioni seguenti. Per altre informazioni, incluso come scegliere le autorizzazioni, vedere Usare le API di Microsoft Defender per endpoint per informazioni dettagliate.
Tipo di autorizzazione | Autorizzazione | Nome visualizzato autorizzazioni |
---|---|---|
Applicazione | RemediationTasks.Read.All | 'Leggere le informazioni sulla vulnerabilità di Gestione delle minacce e delle vulnerabilità' |
Delegato (account aziendale o dell'istituto di istruzione) | RemediationTask.Read | 'Leggere le informazioni sulla vulnerabilità di Gestione delle minacce e delle vulnerabilità' |
Proprietà
Proprietà (ID) | Tipo di dati | Descrizione | Esempio di valore restituito |
---|---|---|---|
Category | Stringa | Categoria dell'attività di correzione (configurazione software/sicurezza) | Software |
completerEmail | Stringa | Se l'attività di correzione è stata completata manualmente da un utente, questa colonna contiene il messaggio di posta elettronica | Nullo |
completerId | Stringa | Se l'attività di correzione è stata completata manualmente da un utente, questa colonna contiene l'ID oggetto | Nullo |
completionMethod | Stringa | Un'attività di correzione può essere completata "automaticamente" (se vengono applicate patch a tutti i dispositivi) o "manualmente" da una persona che seleziona "contrassegna come completata" | Automatico |
createdOn | DateTime | Ora di creazione dell'attività di correzione | 2021-01-12T18:54:11.5499478Z |
Descrizione | Stringa | Descrizione di questa attività di correzione | Aggiornare Microsoft Silverlight a una versione successiva per attenuare le vulnerabilità note che interessano i dispositivi. |
dueOn | DateTime | Data di scadenza impostata dall'autore per questa attività di correzione | 2021-01-13T00:00:00Z |
fixedDevices | . | Numero di dispositivi che sono stati corretti | 2 |
ID | Stringa | ID di questa attività di correzione | 097d9735-5479-4899-b1b7-77398899df92 |
nameId | Stringa | Nome del prodotto correlato | Microsoft Silverlight |
Priorità | Stringa | Priorità impostata dall'autore per questa attività di correzione (High\Medium\Low) | Alto |
Productid | Stringa | ID prodotto correlato | microsoft-_-silverlight |
productivityImpactRemediationType | Stringa | È possibile richiedere alcune modifiche alla configurazione solo per i dispositivi che non influiscono sugli utenti. Questo valore indica la selezione tra "tutti i dispositivi esposti" o "solo i dispositivi senza impatto sull'utente". | AllExposedAssets |
rbacGroupNames | Stringa | Nomi di gruppi di dispositivi correlati | [ "Server Windows", "Windows 11", "Windows 10" ] |
recommendedProgram | Stringa | Programma consigliato per l'aggiornamento a | Nullo |
recommendedVendor | Stringa | Fornitore consigliato per l'aggiornamento a | Nullo |
recommendedVersion | Stringa | Versione consigliata per l'aggiornamento/aggiornamento a | Nullo |
relatedComponent | Stringa | Componente correlato di questa attività di correzione (simile al componente correlato per una raccomandazione di sicurezza) | Microsoft Silverlight |
richiedenteEmail | Stringa | Indirizzo di posta elettronica dell'autore | globaladmin@UserName.contoso.com |
requesterId | Stringa | ID oggetto creatore | r647211f-2e16-43f2-a480-16ar3a2a796r |
requesterNotes | Stringa | Note (testo libero) aggiunte dall'autore per questa attività di correzione | Nullo |
Scid | Stringa | SCID della raccomandazione di sicurezza correlata | Nullo |
Stato | Stringa | Stato dell'attività di correzione (Attivo/Completato) | Attivazione |
statusLastModifiedOn | DateTime | Data di aggiornamento del campo stato | 2021-01-12T18:54:11.5499487Z |
targetDevices | Lungo | Numero di dispositivi esposti a cui è applicabile questa correzione | 43 |
Titolo | Stringa | Titolo di questa attività di correzione | Aggiornare Microsoft Silverlight |
Tipo | Stringa | Tipo di correzione | Update |
vendorId | Stringa | Nome fornitore correlato | Microsoft |
Esempio
Esempio di richiesta
GET https://api.securitycenter.windows.com/api/remediationtasks/
Esempio di risposta
{
"@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
}
]
}
Vedere anche
- Metodi e proprietà di correzione
- Ottenere un'attività correttiva per ID
- Elencare i dispositivi esposti a un'attività correttiva
- Gestione delle vulnerabilità di Microsoft Defender
- Vulnerabilità nell'organizzazione
Consiglio
Per saperne di più, Collaborare con la community di Microsoft Security nella community tech: Microsoft Defender per endpoint Tech Community.