Share via


Import-AipServiceTemplate

Creates a custom protection template for Azure Information Protection.

Syntax

Import-AipServiceTemplate
      -Path <String>
      [<CommonParameters>]

Description

The Import-AipServiceTemplate cmdlet creates a custom protection template for Azure Information Protection and sets its properties according to data contained in a template file.

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

The file you import must be a valid protection template file that has been exported from Azure Information Protection or AD RMS. The file can have any file name extension.

If you import a template file identified by a GUID that matches the GUID of an existing template for the tenant, the original template is overwritten without warning. During the import operation, the GUID for the new template is set to the GUID in the input file, so the new template is valid to consume content protected with the imported template as long as Azure Information Protection has the necessary decryption keys.

If the name of the template in the import file matches the name of an existing template for the tenant in any language, you will have two templates with the same name.

You can store a maximum of 500 custom templates (published or archived) in Azure. If you can't import templates because you have reached this limit as a result of keeping many archived templates, consider exporting them to save the information locally and then removing these templates from Azure Information Protection.

For more information about protection templates, see Configuring and managing templates for Azure Information Protection.

Using the Azure Information Protection unified labeling client?

The Azure Information Protection unified labeling client uses protection templates indirectly. If you have the unified labeling client, we recommend that you use label-based cmdlets instead of modifying your protection templates directly.

For more information, see Create and publish sensitivity labels in the Microsoft 365 documentation.

Examples

Example 1: Import a template file

PS C:\>Import-AipServiceTemplate -Path "C:\MyTemplates\MyFile.xml"

This command imports a template file.

Parameters

-Path

Specifies the path to the template file to import.

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