Поделиться через


Import-AipServiceTemplate

Creates a custom protection template for Azure Information Protection.

Синтаксис

Default (по умолчанию)

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

Описание

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.

Примеры

Example 1: Import a template file

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

This command imports a template file.

Параметры

-Path

Specifies the path to the template file to import.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов: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.