列出所有補救活動

發行項
08/14/2024

適用於：

想要體驗適用於端點的 Microsoft Defender 嗎？註冊免費試用。。

想要體驗Microsoft Defender 弱點管理嗎？深入瞭解如何註冊 Microsoft Defender 弱點管理公開預覽試用版。

重要事項

本文中的部分資訊與發行前版本產品有關，在產品正式發行前可能會大幅度修改。 Microsoft 對此處提供的資訊，不提供任何明確或隱含的瑕疵擔保。

注意事項

如果您是美國政府客戶，請使用適用於美國政府客戶的 Microsoft Defender 中所列的 URI。

提示

為了獲得更好的效能，您可以使用更接近您地理位置的伺服器：

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 描述

傳回所有補救活動的相關信息。

深入瞭解補救活動。

URL： GET：/api/remediationTasks
支援 OData V4 查詢。
OData 支援的運算子：
$filter on： createdon 和 status 屬性。
$top 最大值為 10,000。
$skip.
請參閱適用於端點的 Microsoft Defender 的 OData 查詢範例。

權限

呼叫此 API 需要下列其中一個許可權。若要深入瞭解，包括如何選擇許可權，請參閱使用適用於端點Microsoft Defender API 以取得詳細數據。

許可權類型	權限	許可權顯示名稱
應用程式	RemediationTasks.Read.All	「讀取威脅和弱點管理弱點資訊」
委派 (公司或學校帳戶)	RemediationTask.Read	「讀取威脅和弱點管理弱點資訊」

屬性

屬性 (識別碼)	資料類型	描述	傳回值的範例
類別	字串	軟體/安全性設定 (補救活動的類別)	軟體
completerEmail	字串	如果某人手動完成補救活動，此數據行會包含其電子郵件	Null
completerId	字串	如果某人手動完成補救活動，此數據行會包含其對象標識碼	Null
completionMethod	字串	如果所有裝置都已) 修補，或由選取 [標記為已完成] 的人員「手動」修補，則可以「自動」完成補救活動 (	自動
createdOn	DateTime	建立此補救活動的時間	2021-01-12T18：54：11.5499478Z
描述	字串	此補救活動的描述	將 silverlight Microsoft 更新為更新版本，以減輕影響裝置的已知弱點。
dueOn	DateTime	此補救活動的建立者設定到期日	2021-01-13T00：00：00Z
fixedDevices	.	已修正的裝置數目	2
識別碼	字串	此補救活動的標識碼	097d9735-5479-4899-b1b7-77398899df92
nameId	字串	相關產品名稱	Microsoft Silverlight
優先順序	字串	此補救活動的建立者集優先 (High\Medium\Low)	高
productId	字串	相關產品標識碼	microsoft-_-silverlight
productivityImpactRemediationType	字串	只能針對不會影響用戶的裝置要求一些組態變更。此值表示「所有公開的裝置」或「僅限沒有使用者影響的裝置」之間的選擇。	AllExposedAssets
rbacGroupNames	字串	相關的裝置組名	[ “Windows Servers”， “Windows 11”， “Windows 10” ]
recommendedProgram	字串	要升級至的建議程式	Null
recommendedVendor	字串	建議的廠商升級至	Null
recommendedVersion	字串	要更新/升級至的建議版本	Null
relatedComponent	字串	此補救活動的相關元件 (類似於安全性建議的相關元件)	Microsoft Silverlight
requesterEmail	字串	建立者電子郵件位址	globaladmin@UserName.contoso.com
requesterId	字串	建立者對象識別碼	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	字串	附註 () 為此補救活動新增的建立者免費文字	Null
Scid	字串	相關安全性建議的 SCID	Null
狀態	字串	作用中/已完成) (補救活動狀態	作用中
statusLastModifiedOn	DateTime	狀態欄位更新的日期	2021-01-12T18：54：11.5499487Z
targetDevices	Long	此補救適用的公開裝置數目	43
標題	字串	此補救活動的標題	更新 Microsoft Silverlight
類型	字串	補救類型	更新
vendorId	字串	相關廠商名稱	Microsoft

範例

要求範例

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

回應範例

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

另請參閱

提示

想要深入了解? 在我們的技術社群中與Microsoft安全性社群互動：Microsoft適用於端點的Defender技術社群。

共用方式為

列出所有補救活動

API 描述

權限

屬性

範例

要求範例

回應範例

另請參閱

意見反應

其他資源