az sentinel incident

Note

This reference is part of the sentinel extension for the Azure CLI (version 2.37.0 or higher). The extension will automatically install the first time you run an az sentinel incident command. Learn more about extensions.

Manage incident with sentinel.

Commands

Name	Description	Type	Status
az sentinel incident comment	Manage incident comment with sentinel.	Extension	GA
az sentinel incident comment create	Create the incident comment.	Extension	Experimental
az sentinel incident comment delete	Delete the incident comment.	Extension	Experimental
az sentinel incident comment list	Get all incident comments.	Extension	Experimental
az sentinel incident comment show	Get an incident comment.	Extension	Experimental
az sentinel incident comment update	Update the incident comment.	Extension	Experimental
az sentinel incident create	Create the incident.	Extension	Experimental
az sentinel incident create-team	Create a Microsoft team to investigate the incident by sharing information and insights between participants.	Extension	Experimental
az sentinel incident delete	Delete the incident.	Extension	Experimental
az sentinel incident list	Get all incidents.	Extension	Experimental
az sentinel incident list-alert	Get all incident alerts.	Extension	Experimental
az sentinel incident list-bookmark	Get all incident bookmarks.	Extension	Experimental
az sentinel incident list-entity	Get all incident related entities.	Extension	Experimental
az sentinel incident relation	Manage incident relation with sentinel.	Extension	GA
az sentinel incident relation create	Create the incident relation.	Extension	Experimental
az sentinel incident relation delete	Delete the incident relation.	Extension	Experimental
az sentinel incident relation list	Get all incident relations.	Extension	Experimental
az sentinel incident relation show	Get an incident relation.	Extension	Experimental
az sentinel incident relation update	Update the incident relation.	Extension	Experimental
az sentinel incident run-playbook	Trigger playbook on a specific incident.	Extension	Experimental
az sentinel incident show	Get an incident.	Extension	Experimental
az sentinel incident update	Update the incident.	Extension	Experimental

az sentinel incident create

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Create the incident.

az sentinel incident create --incident-id
                            --resource-group
                            --workspace-name
                            [--classification {BenignPositive, FalsePositive, TruePositive, Undetermined}]
                            [--classification-comment]
                            [--classification-reason {InaccurateData, IncorrectAlertLogic, SuspiciousActivity, SuspiciousButExpected}]
                            [--description]
                            [--etag]
                            [--first-activity-time-utc]
                            [--labels]
                            [--last-activity-time-utc]
                            [--owner]
                            [--provider-incident-id]
                            [--provider-name]
                            [--severity {High, Informational, Low, Medium}]
                            [--status {Active, Closed, New}]
                            [--title]

Required Parameters

--incident-id --name -n

Incident ID.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--workspace-name -w

Experimental

The name of the workspace.

Optional Parameters

--classification

The reason the incident was closed.

accepted values: BenignPositive, FalsePositive, TruePositive, Undetermined

--classification-comment

Describes the reason the incident was closed.

--classification-reason

The classification reason the incident was closed with.

accepted values: InaccurateData, IncorrectAlertLogic, SuspiciousActivity, SuspiciousButExpected

--description

The description of the incident.

--etag

Etag of the azure resource.

--first-activity-time-utc

The time of the first activity in the incident.

--labels

List of labels relevant to this incident Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--last-activity-time-utc

The time of the last activity in the incident.

--owner

Describes a user that the incident is assigned to Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--provider-incident-id

The incident ID assigned by the incident provider.

--provider-name

The name of the source provider that generated the incident.

--severity

The severity of the incident.

accepted values: High, Informational, Low, Medium

--status

The status of the incident.

accepted values: Active, Closed, New

--title

The title of the incident.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az sentinel incident create-team

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Create a Microsoft team to investigate the incident by sharing information and insights between participants.

az sentinel incident create-team --incident-id
                                 --resource-group
                                 --team-name
                                 --workspace-name
                                 [--group-ids]
                                 [--member-ids]
                                 [--team-description]

Required Parameters

--incident-id

Incident ID.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--team-name

The name of the team.

--workspace-name -w

Experimental

The name of the workspace.

Optional Parameters

--group-ids

List of group IDs to add their members to the team Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--member-ids

List of member IDs to add to the team Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--team-description

The description of the team.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az sentinel incident delete

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Delete the incident.

az sentinel incident delete [--ids]
                            [--incident-id]
                            [--resource-group]
                            [--subscription]
                            [--workspace-name]
                            [--yes]

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--incident-id --name -n

Incident ID.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--workspace-name -w

Experimental

The name of the workspace.

--yes -y

Do not prompt for confirmation.

default value: False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az sentinel incident list

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get all incidents.

az sentinel incident list --resource-group
                          --workspace-name
                          [--filter]
                          [--orderby]
                          [--skip-token]
                          [--top]

Required Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--workspace-name -w

Experimental

The name of the workspace.

Optional Parameters

--filter

Filters the results, based on a Boolean condition. Optional.

--orderby

Sorts the results. Optional.

--skip-token

Skiptoken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skiptoken parameter that specifies a starting point to use for subsequent calls. Optional.

--top

Returns only the first n results. Optional.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az sentinel incident list-alert

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get all incident alerts.

az sentinel incident list-alert --incident-id
                                --resource-group
                                --workspace-name

Required Parameters

--incident-id

Incident ID.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--workspace-name -w

Experimental

The name of the workspace.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az sentinel incident list-bookmark

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get all incident bookmarks.

az sentinel incident list-bookmark --incident-id
                                   --resource-group
                                   --workspace-name

Required Parameters

--incident-id

Incident ID.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--workspace-name -w

Experimental

The name of the workspace.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az sentinel incident list-entity

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get all incident related entities.

az sentinel incident list-entity --incident-id
                                 --resource-group
                                 --workspace-name

Required Parameters

--incident-id

Incident ID.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--workspace-name -w

Experimental

The name of the workspace.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az sentinel incident run-playbook

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Trigger playbook on a specific incident.

az sentinel incident run-playbook --incident-identifier
                                  --resource-group
                                  --workspace-name
                                  [--logic-apps-resource-id]
                                  [--tenant-id]

Required Parameters

--incident-identifier

Identifier of incident.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--workspace-name -w

Experimental

The name of the workspace.

Optional Parameters

--logic-apps-resource-id

Resource ID of logic apps.

--tenant-id

ID of tenant.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az sentinel incident show

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get an incident.

az sentinel incident show [--ids]
                          [--incident-id]
                          [--resource-group]
                          [--subscription]
                          [--workspace-name]

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--incident-id --name -n

Incident ID.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--workspace-name -w

Experimental

The name of the workspace.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az sentinel incident update

Experimental

This command is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Update the incident.

az sentinel incident update [--add]
                            [--classification {BenignPositive, FalsePositive, TruePositive, Undetermined}]
                            [--classification-comment]
                            [--classification-reason {InaccurateData, IncorrectAlertLogic, SuspiciousActivity, SuspiciousButExpected}]
                            [--description]
                            [--etag]
                            [--first-activity-time-utc]
                            [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                            [--ids]
                            [--incident-id]
                            [--labels]
                            [--last-activity-time-utc]
                            [--owner]
                            [--provider-incident-id]
                            [--provider-name]
                            [--remove]
                            [--resource-group]
                            [--set]
                            [--severity {High, Informational, Low, Medium}]
                            [--status {Active, Closed, New}]
                            [--subscription]
                            [--title]
                            [--workspace-name]

Optional Parameters

--add

Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.

--classification

The reason the incident was closed.

accepted values: BenignPositive, FalsePositive, TruePositive, Undetermined

--classification-comment

Describes the reason the incident was closed.

--classification-reason

The classification reason the incident was closed with.

accepted values: InaccurateData, IncorrectAlertLogic, SuspiciousActivity, SuspiciousButExpected

--description

The description of the incident.

--etag

Etag of the azure resource.

--first-activity-time-utc

The time of the first activity in the incident.

--force-string

When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.

accepted values: 0, 1, f, false, n, no, t, true, y, yes

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--incident-id --name -n

Incident ID.

--labels

List of labels relevant to this incident Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--last-activity-time-utc

The time of the last activity in the incident.

--owner

Describes a user that the incident is assigned to Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--provider-incident-id

The incident ID assigned by the incident provider.

--provider-name

The name of the source provider that generated the incident.

--remove

Remove a property or an element from a list. Example: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--set

Update an object by specifying a property path and value to set. Example: --set property1.property2=.

--severity

The severity of the incident.

accepted values: High, Informational, Low, Medium

--status

The status of the incident.

accepted values: Active, Closed, New

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--title

The title of the incident.

--workspace-name -w

Experimental

The name of the workspace.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.