按 ID 获取修正活动

项目
05/03/2024

适用于：

希望体验 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

API 说明

返回指定修正活动的信息。显示与获取所有修正活动相同的列，但 仅返回一个指定的修正活动的结果。

详细了解修正活动。

列出 (ID) 的指定修正活动

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

权限

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

权限类型	权限	权限显示名称
应用程序	RemediationTasks.Read.All	“读取威胁和漏洞管理漏洞信息”
委派（工作或学校帐户）	RemediationTask.Read.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/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 for Endpoint技术社区。

通过