根據識別碼取得一個補救活動
適用於:
- 適用於端點的 Microsoft Defender 方案 1
- 適用於端點的 Microsoft Defender
- Microsoft Defender 弱點管理
- Microsoft Defender XDR
想要體驗適用於端點的 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/{id}
權限
呼叫此 API 需要下列其中一個許可權。 若要深入瞭解,包括如何選擇許可權,請參閱使用 適用於端點的 Microsoft Defender API 以取得詳細數據。
許可權類型 | 權限 | 許可權顯示名稱 |
---|---|---|
應用程式 | RemediationTasks.Read.All | 「讀取威脅和弱點管理弱點資訊」 |
委派 (公司或學校帳戶) | RemediationTask.Read.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/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 技術社群。