Remove-AipServiceTemplate
Deletes a protection template for Azure Information Protection.
구문
Default (기본값)
Remove-AipServiceTemplate
-TemplateId <Guid>
[<CommonParameters>]
Description
The Remove-AipServiceTemplate cmdlet deletes a protection template for Azure Information Protection.
You can delete only templates that you have created for your organization. You can set default templates to an archived state but you cannot delete them.
Although you can configure protection 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 Information Protection and discovery services or data recovery.
This cmdlet requires the template ID, which you can get with the Get-AipServiceTemplate 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 protection templates, including how to configure them in the Azure portal, 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.
예제
Example 1: Delete a template
PS C:\>Remove-AipServiceTemplate -TemplateId 36546649-4944-4462-a409-74373a67b6dd
This command deletes the specified template.
매개 변수
-TemplateId
Specifies the GUID of the protection template.
매개 변수 속성
| 형식: | Guid |
| 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.