共用方式為


根據識別碼取得一個補救活動

適用於:

想要體驗適用於端點的 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

API 描述

傳回指定之補救活動的資訊。 會顯示與 取得所有補救活動相同的數據行,但 只會針對指定的補救活動傳回結果。

深入瞭解補救活動

列出 (識別碼) 的指定補救活動

Url: GET: /api/remediationTasks/{id}

權限

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

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

屬性

屬性 (識別碼) 資料類型 描述 傳回值的範例
類別 字串 軟體/安全性設定 (補救活動的類別) 軟體
completerEmail 字串 如果某人手動完成補救活動,此數據行會包含其電子郵件 Null
completerId 字串 如果某人手動完成補救活動,此數據行會包含其對象標識碼 Null
completionMethod 字串 如果所有裝置都已) 修補,或由選取 [標記為已完成] 的人員「手動」修補,則可以「自動」完成補救活動 ( 自動
createdOn DateTime 建立此補救活動的時間 2021-01-12T18:54:11.5499478Z
描述 字串 此補救活動的描述 將 Microsoft Silverlight 更新為更新版本,以減輕影響裝置的已知弱點。
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/03942ef5-aecb-4c6e-b555-d6a97013844c

回應範例

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

另請參閱

提示

想要深入了解? Engage 技術社群中的 Microsoft 安全性社群:適用於端點的 Microsoft Defender 技術社群。