< Back

Remove-AadrmTemplate

Fri Jan 10, 2020 6:26 pm

NAME Remove-AadrmTemplate



SYNOPSIS

Deletes a Rights Management rights policy template.





SYNTAX

Remove-AadrmTemplate -TemplateId <Guid> [<CommonParameters>]





DESCRIPTION

The Remove-AadrmTemplate cmdlet deletes an Azure Rights Management rights policy template.



You can delete only custom templates. You can set default templates to an archived state but you cannot delete

them.



Although you can configure Rights Management templates in the Azure portal, you must use PowerShell to remove

these templates.



After a template is deleted, content protected with that template might become inaccessible. Users who are super

users can continue to access content that was previously protected with a template that is now deleted. For more

information about super users, see Configuring super users for Azure Rights Management and discovery services or

data recovery (https://docs.microsoft.com/information- ... uper-users).



This cmdlet requires the template ID, which you can get with the Get-AadrmTemplate cmdlet.



This cmdlet performs the following operations:



- Displays the template properties.



- Warns that all content protected with this template may become inaccessible.



- Asks to confirm whether to proceed.



- Calls the service to remove the template with the specified GUID.



For more information about custom templates, including how to configure them in the Azure portal, see Configuring

and managing templates for Azure Information Protection

(https://docs.microsoft.com/information- ... -templates).





PARAMETERS

-TemplateId <Guid>

Specifies the GUID of the Rights Management template.



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: Delete a template -----------------



PS C:\\>Remove-AadrmTemplate -TemplateId 36546649-4944-4462-a409-74373a67b6dd



This command deletes the specified template.



RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=400630

Add-AadrmTemplate

Export-AadrmTemplate

Get-AadrmTemplate

Import-AadrmTemplate