通过

列出所有修正活动

  • 项目

适用于：

希望体验 Microsoft Defender for Endpoint？ 注册免费试用版。。

想要体验 Microsoft Defender 漏洞管理？ 详细了解如何注册 Microsoft Defender 漏洞管理公共预览版试用版。

重要

本文中的某些信息与预发行的产品有关，该产品在商业发布之前可能有重大修改。 Microsoft 对此处所提供的信息不作任何明示或默示的保证。

注意

如果你是美国政府客户，请使用 适用于美国政府客户的 Microsoft Defender for Endpoint 中列出的 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 properties。
$top 最大值为 10,000。
$skip.
请参阅 使用 Microsoft Defender for Endpoint 进行 OData 查询的示例。

权限

要调用此 API，需要以下权限之一。 若要了解详细信息（包括如何选择权限），请参阅 使用 Microsoft Defender for Endpoint API 了解详细信息。

权限类型 权限 权限显示名称
应用程序 RemediationTasks.Read.All “读取威胁和漏洞管理漏洞信息”
委派（工作或学校帐户） RemediationTask.Read “读取威胁和漏洞管理漏洞信息”

属性

属性 (ID) 数据类型 说明 返回值的示例
类别 字符串 软件/安全配置 (修正活动的类别) 软件
completerEmail String 如果修正活动是由某人手动完成的，则此列包含其电子邮件 NULL
completerId String 如果修正活动是由某人手动完成的，则此列包含其对象 ID NULL
completionMethod String 如果所有设备都由选择“标记为 (已完成”的人员) 或“手动”修补，则可以“自动”完成修正活动 自动
createdOn 日期时间 创建此修正活动的时间 2021-01-12T18：54：11.5499478Z
说明 String 此修正活动的说明 将 Microsoft Silverlight 更新到更高版本，以缓解影响设备的已知漏洞。
dueOn 日期时间 为此修正活动设置的创建者截止日期 2021-01-13T00：00：00Z
fixedDevices . 已修复的设备数 2
ID String 此修正活动的 ID 097d9735-5479-4899-b1b7-77398899df92
nameId String 相关产品名称 Microsoft Silverlight
优先级 String 为此修正活动设置的创建者优先级 (高\中\低) 高
productId String 相关产品 ID microsoft-_-silverlight
productivityImpactRemediationType String 只能对不影响用户的设备请求一些配置更改。 此值指示在“所有公开设备”或“仅对用户没有影响的设备”之间进行选择。 AllExposedAssets
rbacGroupNames String 相关设备组名称 [ “Windows Server”， “Windows 11”， “Windows 10” ]
recommendedProgram String 要升级到的建议程序 NULL
recommendedVendor String 要升级到的建议供应商 NULL
recommendedVersion String 要更新/升级到的建议版本 NULL
relatedComponent String 此修正活动的相关组件 (类似于安全建议的相关组件) Microsoft Silverlight
requesterEmail String 创建者电子邮件地址 globaladmin@UserName.contoso.com
requesterId String Creator 对象 ID r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes String ) 创建者为此修正活动添加的备注 (自由文本 NULL
Scid String 相关安全建议的 SCID NULL
状态 String 修正活动状态 (活动/已完成) 活动
statusLastModifiedOn 日期时间 更新状态字段的日期 2021-01-12T18：54：11.5499487Z
targetDevices 长型 此修正适用于的公开设备数 43
Title String 此修正活动的标题 更新 Microsoft Silverlight
类型 String 修正类型 更新
vendorId String 相关供应商名称 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 for Endpoint 技术社区。