Wylistuj wszystkie działania korygujące

Artykuł
05/03/2024

Dotyczy:

Chcesz poznać usługę ochrony punktu końcowego w usłudze Microsoft Defender? Utwórz konto bezpłatnej wersji próbnej.

Chcesz doświadczyć Zarządzanie lukami w zabezpieczeniach w usłudze Microsoft Defender? Dowiedz się więcej o tym, jak można zarejestrować się w Zarządzanie lukami w zabezpieczeniach w usłudze Microsoft Defender publicznej wersji zapoznawczej.

Ważna

Niektóre informacje zawarte w tym artykule odnoszą się do wersji wstępnej produktu, który może zostać znacznie zmodyfikowany do czasu wydania wersji komercyjnej. Firma Microsoft nie udziela żadnych gwarancji, wyrażonych ani dorozumianych, w odniesieniu do informacji podanych tutaj.

Uwaga

Jeśli jesteś klientem rządowym USA, użyj identyfikatorów URI wymienionych w Ochrona punktu końcowego w usłudze Microsoft Defender dla klientów rządowych USA.

Porada

Aby uzyskać lepszą wydajność, możesz użyć serwera bliżej lokalizacji geograficznej:

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

Opis interfejsu API

Zwraca informacje o wszystkich działaniach korygowania.

Dowiedz się więcej o działaniach korygowania.

ADRES URL: GET: /api/remediationTasks
Obsługuje zapytania OData V4.
Obsługiwane operatory OData:
$filter on: createdon i status właściwości.
$top z maksymalną wartością 10 000.
$skip.
Zobacz przykłady w temacie Zapytania OData z Ochrona punktu końcowego w usłudze Microsoft Defender.

Uprawnienia

Do wywołania tego interfejsu API jest wymagane jedno z następujących uprawnień. Aby dowiedzieć się więcej, w tym jak wybrać uprawnienia, zobacz Używanie interfejsów API Ochrona punktu końcowego w usłudze Microsoft Defender, aby uzyskać szczegółowe informacje.

Typ uprawnień	Uprawnienie	Nazwa wyświetlana uprawnień
Aplikacja	RemediationTasks.Read.All	"Odczytywanie informacji o lukach w zabezpieczeniach dotyczących zarządzania zagrożeniami i lukami w zabezpieczeniach"
Delegowane (konto służbowe)	RemediationTask.Read	"Odczytywanie informacji o lukach w zabezpieczeniach dotyczących zarządzania zagrożeniami i lukami w zabezpieczeniach"

Właściwości

Właściwość (ID)	Typ danych	Opis	Przykład zwracanej wartości
Kategoria	Ciąg	Kategoria działania korygowania (konfiguracja oprogramowania/zabezpieczeń)	Oprogramowanie
completerEmail	Ciąg	Jeśli działanie korygujące zostało wykonane ręcznie przez kogoś, ta kolumna zawiera adres e-mail	Null
completerId	Ciąg	Jeśli działanie korygowania zostało wykonane ręcznie przez kogoś, ta kolumna zawiera identyfikator obiektu	Null
completionMethod	Ciąg	Działanie korygowania może zostać wykonane "automatycznie" (jeśli wszystkie urządzenia zostaną poprawione) lub "ręcznie" przez osobę, która wybierze pozycję "oznacz jako ukończone"	Automatyczne
createdOn	Datetime	Czas utworzenia tego działania korygowania	2021-01-12T18:54:11.5499478Z
Opis	Ciąg	Opis tego działania korygowania	Zaktualizuj program Microsoft Silverlight do nowszej wersji, aby ograniczyć znane luki w zabezpieczeniach wpływające na urządzenia.
dueOn	Datetime	Data ukończenia ustawiona przez twórcę dla tego działania korygowania	2021-01-13T00:00:00Z
fixedDevices	.	Liczba urządzeń, które zostały naprawione	2
ID	Ciąg	Identyfikator tego działania korygowania	097d9735-5479-4899-b1b7-77398899df92
nameId	Ciąg	Pokrewna nazwa produktu	Microsoft Silverlight
Priority (Priorytet)	Ciąg	Priorytet dla tego działania korygowania ustawionego przez twórcę (High\Medium\Low)	High (Wysoki)
Productid	Ciąg	Identyfikator produktu pokrewne	microsoft-_-silverlight
productivityImpactRemediationType	Ciąg	Można zażądać kilku zmian konfiguracji tylko w przypadku urządzeń, które nie mają wpływu na użytkowników. Ta wartość wskazuje wybór między "wszystkimi uwidocznionymi urządzeniami" lub "tylko urządzeniami bez wpływu na użytkownika".	AllExposedAssets
rbacGroupNames	Ciąg	Nazwy powiązanych grup urządzeń	[ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram	Ciąg	Zalecany program do uaktualnienia do	Null
recommendedVendor	Ciąg	Zalecany dostawca do uaktualnienia do	Null
recommendedVersion	Ciąg	Zalecana wersja do aktualizacji/uaktualnienia do	Null
Relatedcomponent	Ciąg	Powiązany składnik tego działania korygowania (podobny do powiązanego składnika zalecenia dotyczącego zabezpieczeń)	Microsoft Silverlight
requesterEmail	Ciąg	Adres e-mail twórcy	globaladmin@UserName.contoso.com
requesterId	Ciąg	Identyfikator obiektu twórcy	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	Ciąg	Notatki (bezpłatny tekst) dodane przez twórcę dla tego działania korygowania	Null
Scid	Ciąg	SCID powiązanego zalecenia dotyczącego zabezpieczeń	Null
Stan	Ciąg	Stan działania korygowania (aktywny/ukończony)	Aktywny
statusLastModifiedOn	Datetime	Data aktualizacji pola stanu	2021-01-12T18:54:11.5499487Z
targetDevices	Długi	Liczba uwidocznionych urządzeń, których dotyczy to korygowanie	43
Tytuł	Ciąg	Tytuł tego działania korygowania	Aktualizowanie programu Microsoft Silverlight
Wpisać	Ciąg	Typ korygowania	Aktualizacja
Vendorid	Ciąg	Nazwa powiązanego dostawcy	Microsoft

Przykład

Przykład żądania

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

Przykład odpowiedzi

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

Zobacz też