Jaa

az sentinel incident

  • Reference

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 <indexToRemove> 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=<value>.

--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.