Export-AadrmTemplate

Exports the properties of a rights policy template to a file.

Syntax

Export-AadrmTemplate
      -TemplateId <Guid>
      -Path <String>
      [-Force]
      [<CommonParameters>]

Description

Note

This cmdlet from the AADRM module is now deprecated. After July 15, 2020, this cmdlet name will be supported only as an alias to its replacement in the AIPService module.

For more information, see the overview page.

The Export-AadrmTemplate cmdlet exports all the properties of a Rights Management template to a file. You can then import the template to another Azure Rights Management tenant or you can edit it and import it back to the original tenant. You can use this technique to perform bulk edits of complex properties in templates, such as multilingual names and descriptions.

Although you can configure Rights Management templates in the Azure portal, you must use PowerShell to export and import these templates.

Tip: Consider using this cmdlet as a way to back up your custom templates, so that you can revert to a known-good version if required.

The export process does not automatically append a file name extension, so you can specify a file name extension to match the application that you will use to view and edit the resulting data.

You can use the Get-AadrmTemplate cmdlet to get the GUIDs of all templates.

For more information about custom templates, including how to configure them in the Azure portal, see Configuring and managing templates for Azure Information Protection.

Examples

Example 1: Export a template

PS C:\>Export-AadrmTemplate -Path "C:\MyTemplates\MyTemplateFile.xml" -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428

This command exports the specified template to the file named MyTemplateFile.xml.

Parameters

-Force

Indicates that the cmdlet overwrites an existing template file that has the same path.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Specifies the path to the location where you want to save the file.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TemplateId

Specifies the GUID of an Rights Management template.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False