Set-AipServiceTemplateProperty

구문

Set-AipServiceTemplateProperty
   -TemplateId <Guid>
   [-Names <Hashtable>]
   [-Descriptions <Hashtable>]
   [-RightsDefinitions <System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition]>]
   [-ContentExpirationOption <ContentExpirationType>]
   [-ContentExpirationDate <DateTime>]
   [-ContentValidityDuration <Int32>]
   [-LicenseValidityDuration <Int32>]
   [-Status <TemplateStatus>]
   [-ScopedIdentities <System.Collections.Generic.List`1[System.String]>]
   [-EnableInLegacyApps <Boolean>]
   [<CommonParameters>]

Description

Set-AipServiceTemplateProperty cmdlet은 Azure Information Protection에 대한 보호 템플릿의 속성 또는 속성을 업데이트합니다. Azure Portal에서 이러한 속성의 대부분을 업데이트할 수 있습니다.

이 cmdlet을 사용하는 경우 템플릿은 기존 보호 템플릿을 참조해야 하는 GUID로 식별됩니다. 이 cmdlet을 사용하여 기본 템플릿을 업데이트할 수 없습니다.

Get-AipServiceTemplate cmdlet을 사용하여 템플릿 ID를 가져올 수 있습니다.

가장 좋은 방법은 Export-AipServiceTemplate cmdlet을 사용하여 이 cmdlet을 실행하기 전에 기존 템플릿을 백업하는 것입니다. 그런 다음 원래 구성으로 되돌려야 하는 경우 Import-AipServiceTemplate cmdlet을 사용하여 템플릿을 복원할 수 있습니다.

Azure Portal에서 템플릿을 구성하는 방법을 포함하여 보호 템플릿에 대한 자세한 내용은 Azure Information Protection대한 템플릿 구성 및 관리 참조하세요.

Azure Information Protection 통합 레이블 지정 클라이언트를 사용하시겠습니까?

Azure Information Protection 통합 레이블 지정 클라이언트는 보호 템플릿을 간접적으로 사용합니다. 통합 레이블 지정 클라이언트가 있는 경우 보호 템플릿을 직접 수정하는 대신 레이블 기반 cmdlet을 사용하는 것이 좋습니다.

자세한 내용은 Microsoft 365 설명서에서 민감도 레이블 만들기 및 게시를 참조하세요.

예제

예제 1: 템플릿의 상태 업데이트

PS C:\>Set-AipServiceTemplateProperty -TemplateID 28168524-29c3-44f1-9e11-ea6c60bb6428 -Status Published

이 명령은 템플릿 상태를 게시된설정합니다.

예제 2: 보호 템플릿에 대한 사용자 및 권한 지정

PS C:\> $r1 = New-AipServiceRightsDefinition -EmailAddress marketing@contoso.com -Rights "VIEW","EXPORT"
PS C:\> $r2 = New-AipServiceRightsDefinition -EmailAddress engineering@contoso.com -Rights "VIEW"
PS C:\>Set-AipServiceTemplateProperty -TemplateID 28168524-29c3-44f1-9e11-ea6c60bb6522 -RightsDefinitions ($r1, $r2)

다음은 새 사용자 및 권한에 대한 새 시작 - 기밀 콘텐츠 기존 보호 템플릿을 업데이트하는 예제입니다. 기존 템플릿에서 마케팅 부서에 대한 보기 및 내보내기 권한을 부여한 반면(변경해서는 안 됨) 엔지니어링 부서에도 보기 권한이 있어야 합니다.

RightsDefinitions 매개 변수를 지정하면 기존 설정이 덮어쓰여지므로 첫 번째 권한 정의 개체는 마케팅에 대한 기존 설정을 유지하고 다른 권한 정의 개체는 새 엔지니어링 부서 권한을 만듭니다.

예제 3: 보호 템플릿에 새 사용자 및 권한 추가

PS C:\> $templateid = "7b1db17a-cb1a-41cf-bad7-b452f9d384c1"
PS C:\> [array]$r = New-AipServiceRightsDefinition -EmailAddress pattiful@contoso.com -Rights "DOCEDIT", "EXTRACT"
PS C:\> $r += New-AipServiceRightsDefinition -EmailAddress evannar@vanarsdelltd.com -Rights "VIEW"
PS C:\> $CurrentRightsDefinitions = [array]((get-AipServiceTemplate -TemplateId $templateid).RightsDefinitions)
PS C:\> $ResultingRightsDefinitions = $CurrentRightsDefinitions + $r
PS C:\> Set-AipServiceTemplateProperty -TemplateId $templateid -RightsDefinition $ResultingRightsDefinitions

이 명령 집합은 템플릿에 이미 정의된 기존 사용자 및 권한을 덮어쓰지 않고 두 명의 새 사용자와 해당 다른 권한을 기존 템플릿에 추가합니다.

새 사용자와 해당 권한은 DOCEDIT 부여되고 권한을 추출할 있는 pattiful.contoso.com(조직 내 사용자)입니다. VIEW 권한이 부여된 (다른 조직의 사용자). 이러한 사용자 및 해당 권한은 배열을 사용하여 권한 정의 개체에 추가된 다음 템플릿에 대한 기존 권한 정의에 추가됩니다.

매개 변수

-ContentExpirationDate

-ContentExpirationOption

-ContentValidityDuration

-Descriptions

-EnableInLegacyApps

-LicenseValidityDuration

-Names

-RightsDefinitions

-ScopedIdentities

-Status

-TemplateId

관련 링크

• Get-AipServiceTemplate
• Get-AipServiceTemplateProperty