命名空间: microsoft.graph.security
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示事件的修正操作。 当适用于 XDR 的 Microsoft Defender 专家确定所需的操作时,它会创建一个任务供你查看和处理。 通过门户或使用此 API 查看这些任务并采取措施。
继承自 microsoft.graph.entity。
方法
属性
| 属性 |
类型 |
说明 |
| actionStatus |
microsoft.graph.security.incidentTaskActionStatus |
操作的执行状态。 可能的值包括 notStarted、inProgress、partiallyCompleted、completed、failed、unknownFutureValue。 有关详细信息,请参阅 incidentTaskActionStatus 值。 |
| actionType |
microsoft.graph.security.incidentTaskActionType |
要执行的修正操作。 可能的值为: text、 isolateDevice、 enableUsersoftDeleteEmailunknownFutureValueunRestrictAppExecutionunIsolateDevicehardDeleteEmailrequireSignInmarkUserAsCompromiseddisableUsersubmitIocRulecollectInvestigationPackageforceUserPasswordResetstopAndQuarantineFilerunAntiVirusScanrestrictAppExecution。 有关详细信息,请参阅 incidentTaskActionType 值。 |
| createdByDisplayName |
String |
创建任务的实体的名称。 只读。 |
| createdDateTime |
DateTimeOffset |
任务的创建时间。 只读。 |
| description |
String |
修正操作的说明。 |
| displayName |
String |
任务的标题。 |
| id |
String |
任务的唯一 GUID 标识符。 |
| lastModifiedByDisplayName |
String |
上次更新任务的实体名称。 只读。 |
| lastModifiedDateTime |
DateTimeOffset |
任务的上次更新时间。 只读。 |
| responseAction |
microsoft.graph.security.incidentTaskResponseAction |
回应操作。 |
| source |
microsoft.graph.security.incidentTaskSource |
任务的来源。 可能的值包括 defenderExpertsGuidedResponse、defenderExpertsManagedResponse、unknownFutureValue。 有关详细信息,请参阅 incidentTaskSource 值。 |
| status |
microsoft.graph.security.incidentTaskStatus |
当前任务状态。 此属性是唯一可以更新的属性。 可能的值包括 open、inProgress、completed、failed、notRelevant、unknownFutureValue。 有关详细信息,请参阅 incidentTaskStatus 值。 |
incidentTaskActionStatus 值
| 成员 |
说明 |
| notStarted |
与事件任务相关的操作未启动。 |
| inProgress |
与事件任务相关的操作正在进行中。 |
| partiallyCompleted |
与事件任务相关的操作部分完成。 |
| completed |
与事件任务相关的操作已完成。 |
| 失败 |
与事件任务相关的操作失败。 |
| unknownFutureValue |
可进化枚举哨兵值。 请勿使用。 |
incidentTaskActionType 值
| 成员 |
说明 |
| text |
操作可以是任何自由文本,例如,SOC 可以指导客户格式化其设备。 |
| isolateDevice |
使用 Microsoft Defender for Endpoint 应用完全网络隔离,防止设备连接到任何应用程序或服务。 |
| stopAndQuarantineFile |
使用 Microsoft Defender for Endpoint 从设备中删除文件。 |
| runAntiVirusScan |
在设备上执行 Microsoft Defender 防病毒扫描。 |
| collectInvestigationPackage |
使用 Microsoft Defender for Endpoint 收集设备日志并将其存储在 ZIP 文件中。 |
| restrictAppExecution |
对设备设置限制,仅允许运行使用 Microsoft 颁发的证书签名的可执行文件。 |
| submitIocRule |
提交 IOC 规则。 |
| forceUserPasswordReset |
强制用户重置其密码。 |
| disableUser |
暂时阻止用户登录到本地。 |
| markUserAsCompromised |
在 Azure Active Directory 中将用户风险级别设置为“高”。 |
| requireSignIn |
要求用户重新登录。 |
| hardDeleteEmail |
删除电子邮件。 |
| softDeleteEmail |
将电子邮件移动到已删除文件夹。 |
| unIsolateDevice |
还原 isolateDevice 响应操作。 |
| unRestrictAppExecution |
恢复 restrictAppExecution 响应操作。 |
| enableUser |
还原 disableUser 响应操作。 |
| unknownFutureValue |
可进化枚举哨兵值。 请勿使用。 |
incidentTaskSource 值
| 成员 |
说明 |
| defenderExpertsGuidedResponse |
Defender 专家事件任务在客户上挂起执行。 |
| defenderExpertsManagedResponse |
Defender 专家事件任务执行由 Defender 专家完成。 |
| unknownFutureValue |
可进化枚举哨兵值。 请勿使用。 |
incidentTaskStatus 值
| 成员 |
说明 |
| open |
事件任务标记为打开。 |
| inProgress |
事件任务标记为正在进行。 |
| completed |
事件任务标记为已完成。 |
| 失败 |
事件任务标记为失败。 操作执行失败也会将事件任务状态设置为失败。 |
| notRelevant |
事件任务标记为不相关。 |
| unknownFutureValue |
可进化枚举哨兵值。 请勿使用。 |
关系
JSON 表示形式
以下 JSON 显示资源类型结构。
{
"@odata.type": "#microsoft.graph.security.incidentTask",
"id": "String (identifier)",
"status": "String",
"source": "String",
"displayName": "String",
"description": "String",
"createdDateTime": "String (timestamp)",
"createdByDisplayName": "String",
"lastModifiedDateTime": "String (timestamp)",
"lastModifiedByDisplayName": "String",
"actionStatus": "String",
"actionType": "String",
"incident": {
"@odata.type": "microsoft.graph.security.incident",
"id": "String"
}
}