Microsoft Sentinel
Cloud and workloads

Export and import automation rules to and from ARM templates

In brief

The article now uses clearer export/import section headings and anchors, clarifies that exported JSON includes all automation-rule parameters, and updates the troubleshooting reference and metadata.

What Defender admins need to know

No administrator action is indicated; use the updated section links and troubleshooting reference when consulting the article.

Summaries are generated from the documentation change itself.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Export and import automation rules to and from ARM templates

Manage your Microsoft Sentinel automation rules as code! You can now export your automation rules to Azure Resource Manager (ARM) template files, and import rules from these files, as part of your program to manage and control your Microsoft Sentinel deployments as code. The export action creates a JSON file in your browser's downloads location, that youlocation. You can then rename, move, and otherwise handle the file like any other file.

The exported JSON file is workspace-independent, so it can be imported to other workspaces and even other tenants. As code, it can also be version-controlled, updated, and deployed in a managed CI/CD framework.

The exported JSON file includes all the parameters defined in the automation rule. Rules of any trigger type can be exported to a JSON file.

This article shows yousection explains how to export and import Microsoft Sentinel automation rules.

[!INCLUDE unified-soc-preview]

Export automation rules to ARM templates

To export one or more automation rules to a JSON file, perform the following steps:

>
> - When you export multiple rules at once, a single file (named *Azure_Sentinel_automation_rules.json*) is created, and contains JSON code for all the exported rules.

Import automation rules from ARM templates

To import automation rules from an ARM template JSON file, perform the following steps:

Troubleshooting

If you have any issues importing an exported automation rule, consult the following table.troubleshooting table in this section.

Behavior (with error) Reason Suggested action