名前空間: microsoft.graph.security
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
インシデントの修復アクションを表します。 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、 stopAndQuarantineFile、 runAntiVirusScan、 collectInvestigationPackage、 restrictAppExecution、 submitIocRule、 forceUserPasswordReset、 disableUser、 markUserAsCompromised、 requireSignIn、 hardDeleteEmail、 softDeleteEmail、 unIsolateDevice、 unRestrictAppExecution、 enableUser、 unknownFutureValue です。 詳細については、 incidentTaskActionType の値を参照してください。 |
| createdByDisplayName |
文字列 |
タスクを作成したエンティティの名前。 読み取り専用です。 |
| createdDateTime |
DateTimeOffset |
タスクの作成時刻。 読み取り専用です。 |
| 説明 |
String |
修復アクションの説明。 |
| displayName |
String |
タスクのタイトル。 |
| id |
文字列 |
タスクの一意の GUID 識別子。 |
| lastModifiedByDisplayName |
文字列 |
タスクを最後に更新したエンティティの名前。 読み取り専用です。 |
| 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 値
| メンバー |
説明 |
| テキスト |
アクションは任意のフリー テキストにすることができます。たとえば、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 Experts インシデント タスクは、顧客の実行が保留中です。 |
| defenderExpertsManagedResponse |
Defender Experts インシデント タスクの実行は、Defender Experts によって実行されます。 |
| 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"
}
}