< Back
Import-AadrmTemplate
Post
NAME Import-AadrmTemplate
SYNOPSIS
Creates a custom Rights Management policy template.
SYNTAX
Import-AadrmTemplate -Path <String> [<CommonParameters>]
DESCRIPTION
The Import-AadrmTemplate cmdlet creates a custom Rights Management template for Azure Rights Management and sets
its properties according to data contained in a template file.
Although you can configure Rights Management templates in the Azure portal, you must use PowerShell to export and
import these templates.
The file you import must be a valid Rights Management template file that has been exported from Azure RMS 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 RMS 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 RMS.
For more information about custom templates, see Configuring and managing templates for Azure Information
Protection (https://docs.microsoft.com/information- ... -templates).
PARAMETERS
-Path <String>
Specifies the path to the template file to import.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
-------------- Example 1: Import a template file --------------
PS C:\\>Import-AadrmTemplate -Path "C:\\MyTemplates\\MyFile.xml"
This command imports a template file.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkID=400628
Add-AadrmTemplate
Export-AadrmTemplate
Get-AadrmTemplate
Remove-AadrmTemplate
SYNOPSIS
Creates a custom Rights Management policy template.
SYNTAX
Import-AadrmTemplate -Path <String> [<CommonParameters>]
DESCRIPTION
The Import-AadrmTemplate cmdlet creates a custom Rights Management template for Azure Rights Management and sets
its properties according to data contained in a template file.
Although you can configure Rights Management templates in the Azure portal, you must use PowerShell to export and
import these templates.
The file you import must be a valid Rights Management template file that has been exported from Azure RMS 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 RMS 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 RMS.
For more information about custom templates, see Configuring and managing templates for Azure Information
Protection (https://docs.microsoft.com/information- ... -templates).
PARAMETERS
-Path <String>
Specifies the path to the template file to import.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
-------------- Example 1: Import a template file --------------
PS C:\\>Import-AadrmTemplate -Path "C:\\MyTemplates\\MyFile.xml"
This command imports a template file.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkID=400628
Add-AadrmTemplate
Export-AadrmTemplate
Get-AadrmTemplate
Remove-AadrmTemplate