Edit

Save-AzResourceGroupDeploymentTemplate

Save the template used for a resource group deployment to a file.

Syntax

Default (Default)

Save-AzResourceGroupDeploymentTemplate
    -ResourceGroupName <string>
    -Name <string>
    [-SubscriptionId <string>]
    [-Path <string>]
    [-Force]
    [-Profile <string>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exports the Azure Resource Manager template that a resource-group-scoped deployment was created from and writes it to a file on disk. The operation is read-only: it never creates or modifies resources. Azure Resource Manager returns the template exactly as it was submitted, with parameters and variables left unresolved, so the saved file can be fed straight back into New-AzResourceGroupDeployment -TemplateFile.

The cmdlet emits an object carrying the full path of the file that was written. Exporting a deployment that does not exist fails with DeploymentNotFound. The subscription defaults to the active profile's subscription unless -SubscriptionId is supplied.

-Path follows the same rules as the legacy cmdlet: when it names an existing directory the file is written there as <deployment name>.json; any other value is treated as the file itself and gains a .json extension when it lacks one. A relative path is resolved against the current PowerShell location, and any missing parent directories are created. When -Path is omitted the file is written to the current location as <deployment name>.json.

If the destination file already exists the cmdlet fails rather than overwriting it. Pass -Force to overwrite.

Examples

Save a deployment template to the current directory

Writes infra-prod-2026-06-18.json to the current location.

Save-AzResourceGroupDeploymentTemplate -ResourceGroupName myrg -Name infra-prod-2026-06-18

Save a deployment template to a specific directory

The directory already exists, so the file is written as C:\templates\infra-prod-2026-06-18.json.

Save-AzResourceGroupDeploymentTemplate -ResourceGroupName myrg -Name infra-prod-2026-06-18 -Path C:\templates

Save a deployment template under a chosen file name

Save-AzResourceGroupDeploymentTemplate -ResourceGroupName myrg -Name infra-prod-2026-06-18 -Path .\exported\prod-baseline.json

Overwrite an existing file

Without -Force a second run against the same destination fails instead of replacing the file.

Save-AzResourceGroupDeploymentTemplate -ResourceGroupName myrg -Name infra-prod-2026-06-18 -Path .\prod.json -Force

Redeploy from the saved template

$saved = Save-AzResourceGroupDeploymentTemplate -ResourceGroupName myrg -Name infra-prod-2026-06-18 -Force
New-AzResourceGroupDeployment -ResourceGroupName myrg -Name infra-prod-replay -TemplateFile $saved.Path

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

Overwrite the destination file when it already exists. Without this switch an existing file causes a terminating error and the file is left untouched.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

The name of the deployment whose template to save.

Parameter properties

Type:String
Supports wildcards:False
DontShow:False
Aliases:DeploymentName

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Path

The output path of the template file. An existing directory receives <deployment name>.json; any other value is used as the file name and gains a .json extension when it lacks one. Relative paths are resolved against the current PowerShell location. Defaults to the current location.

Parameter properties

Type:String
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Profile

Use the named profile for this command, overriding the active profile.

Parameter properties

Type:String
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResourceGroupName

The name of the resource group that contains the deployment.

Parameter properties

Type:String
Supports wildcards:False
DontShow:False
Aliases:ResourceGroup

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-SubscriptionId

Azure subscription id. Defaults to the active profile's subscription.

Parameter properties

Type:String
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Runs the command in a mode that only reports what would happen without performing the actions.

Parameter properties

Type:SwitchParameter
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

String

You can pipe the ResourceGroupName, Name, and Path values to this cmdlet by property name, for example the output of Get-AzResourceGroupDeployment.

Outputs

Microsoft.Azure.Azclips.Extensions.Resources.Processors.DeploymentTemplateSaveResult

An object with a single Path property carrying the full path of the template file that was written.

Notes

The exported template is the template as submitted, not the resolved deployment output: parameter references and variables are preserved rather than replaced with their runtime values. Use Get-AzResourceGroupDeployment to inspect the parameter values a deployment actually ran with.