New-ComplianceTag

모듈:

ExchangePowerShell

적용 대상:

Security & Compliance

이 cmdlet은 보안 & 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 & 준수 PowerShell을 참조하세요.

New-ComplianceTag cmdlet을 사용하여 Microsoft Purview 규정 준수 포털 보존 레이블을 만듭니다. 보존 레이블은 콘텐츠에 보존 설정을 적용합니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

Syntax

New-ComplianceTag
   [-Name] <String>
   [-Comment <String>]
   [-ComplianceTagForNextStage <String>]
   [-Confirm]
   [-EventType <ComplianceRuleIdParameter>]
   [-FilePlanProperty <String>]
   [-FlowId <System.Guid>]
   [-Force]
   [-IsRecordLabel <Boolean>]
   [-IsRecordUnlockedAsDefault <Boolean>]
   [-MultiStageReviewProperty <String>]
   [-Notes <String>]
   [-Regulatory <Boolean>]
   [-RetentionAction <String>]
   [-RetentionDuration <Unlimited>]
   [-RetentionType <String>]
   [-ReviewerEmail <SmtpAddress[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

보안 & 준수 PowerShell에서 이 cmdlet을 사용하려면 권한이 할당되어야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.

예제

예 1

New-ComplianceTag -Name "HR Content" -RetentionAction Keep -RetentionDuration 1825 -RetentionType ModificationAgeInDays

이 예제에서는 다음 설정을 사용하여 HR Content라는 새 레이블을 만듭니다.

• 작업: 유지합니다.
• 기간: 5년(1825일)
• 형식: 수정 기간(일)입니다.

매개 변수

-Comment

Comment 매개 변수는 설명(선택 사항)을 지정합니다. 공백이 포함된 값을 지정하는 경우 값을 큰따옴표(")로 묶어야 합니다(예: “이는 관리자 정보입니다”).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ComplianceTagForNextStage

{{ Fill ComplianceTagForNextStage Description }}

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Confirm

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

• 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
• 대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-EventType

EventType은 레이블과 연결된 보존 규칙을 지정합니다. 규칙을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

• 이름
• DN(고유 이름)
• GUID

Get-RetentionComplianceRule cmdlet를 사용하여 사용 가능한 보존 규칙을 볼 수 있습니다.

Type:	ComplianceRuleIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-FilePlanProperty

FilePlanProperty 매개 변수는 레이블에 포함할 파일 계획 속성을 지정합니다. 이 매개 변수에서 사용해야 하는 파일 계획 속성 이름을 보려면 다음 명령을 실행합니다.

• Get-FilePlanPropertyAuthority | Format-List Name
• Get-FilePlanPropertyCategory | Format-List Name
• Get-FilePlanPropertyCitation | Format-List Name
• Get-FilePlanPropertyDepartment | Format-List Name
• Get-FilePlanPropertyReferenceId | Format-List Name
• Get-FilePlanPropertySubCategory | Format-List Name

이 매개 변수의 유효한 값에는 다음 두 단계가 포함됩니다.

• 다음 구문을 사용하여 파일 계획 속성을 PSCustomObject로 저장하는 변수입니다.

  $Variable1=[PSCustomObject]@{Settings=@(@{Key="FilePlanPropertyDepartment";Value="Name"},@{Key="FilePlanPropertyCategory";Value="Name"},@{Key="FilePlanPropertySubcategory";Value="Name"},@{Key="FilePlanPropertyCitation";Value="Name"},@{Key="FilePlanPropertyReferenceId";Value="Name"},@{Key="FilePlanPropertyAuthority";Value="Name"})}

  예를 들면

  $retentionLabelAction=[PSCustomObject]@{Settings=@(@{Key="FilePlanPropertyDepartment";Value="Legal"},@{Key="FilePlanPropertyCategory";Value="Tax"},@{Key="FilePlanPropertySubcategory";Value="US_Tax"},@{Key="FilePlanPropertyCitation";Value="LegalCitation"},@{Key="FilePlanPropertyReferenceId";Value="ReferenceA"},@{Key="FilePlanPropertyAuthority"; Value="Auth1"})}

• 다음 구문을 사용하여 PSCustomObject를 JSON 개체로 변환하는 두 번째 변수입니다.

  $Variable2 = ConvertTo-Json $Variable1

  예를 들면

  $fpStr = ConvertTo-Json $retentionLabelAction

이 매개 변수의 값으로 두 번째 변수를 사용합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-FlowId

참고: 이 매개 변수는 현재 미리 보기로 제공되며, 모든 조직에서 사용할 수 없으며 변경될 수 있습니다.

FlowId 매개 변수는 보존 기간이 끝날 때 실행할 Power Automate 흐름을 지정합니다. 이 매개 변수의 유효한 값은 흐름의 GUID 값입니다.

다음 방법 중 하나를 사용하여 흐름의 GUID 값을 찾을 수 있습니다.

• Power Automate 포털에서 흐름으로 이동합니다. 흐름의 GUID 값은 URL에 있습니다.
• '흐름 나열'이라는 Power Automate 작업을 사용합니다.

Type:	System.Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Force

강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-IsRecordLabel

IsRecordLabel 매개 변수는 레이블이 레코드 레이블인지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

• $true: 레이블이 레코드 레이블입니다. 레이블이 콘텐츠에 적용되면 레이블을 제거할 수 없습니다.
• $false: 레이블이 레코드 레이블이 아닙니다. 이 값은 기본값입니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-IsRecordUnlockedAsDefault

{{ Fill IsRecordUnlockedAsDefault Description }}

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-MultiStageReviewProperty

MultiStageReviewProperty 매개 변수는 레이블에 포함할 다단계 검토 속성을 지정합니다. 이 매개 변수에는 다음 구문을 사용할 수 있습니다.

'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[reviewer1,reviewer2,...reviewerN]},{"StageName":"Stage2","Reviewers":[reviewer1,reviewer2,...reviewerN]},]}'

예를 들면

'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[jie@contoso.onmicrosoft.com]},{"StageName":"Stage2","Reviewers":[bharath@contoso.onmicrosoft.com,helen@contoso.onmicrosoft.com]},]}'

이 구문은 각 검토 단계 ID, 검토 단계 이름 및 검토자 목록을 정의하는 JSON 개체입니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Name

Name 매개 변수는 레이블의 고유한 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Notes

Notes 매개 변수는 개체에 대한 추가 정보를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Regulatory

{{ 규정 설명 채우기 }}

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetentionAction

RetentionAction 매개 변수는 레이블에 대한 작업을 지정합니다. 유효한 값은 다음과 같습니다.

• 삭제
• 유지
• KeepAndDelete

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetentionDuration

RetentionDuration 매개 변수는 콘텐츠를 보관할 일 수를 지정합니다. 유효한 값은 다음과 같습니다.

• 양의 정수
• unlimited 값

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetentionType

RetentionType 매개 변수는 콘텐츠 생성 날짜, 태그가 지정된 날짜 또는 마지막 수정 날짜에서 보존 기간을 계산할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

• CreationAgeInDays
• EventAgeInDays
• ModificationAgeInDays
• TaggedAgeInDays

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ReviewerEmail

ReviewerEmail 매개 변수는 삭제 및 KeepAndDelete 보존 작업에 대한 검토자의 이메일 주소를 지정합니다. 전자 메일 주소가 여러 개인 경우 각 주소를 쉼표로 구분하여 지정할 수 있습니다.

Type:	SmtpAddress[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-WhatIf

WhatIf 스위치는 보안 & 준수 PowerShell에서 작동하지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance