다음을 통해 공유


New-RetentionComplianceRule

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

New-RetentionComplianceRule cmdlet을 사용하여 Microsoft Purview 규정 준수 포털 새 보존 규칙을 만듭니다.

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

구문

ComplianceTag

New-RetentionComplianceRule
    -ApplyComplianceTag <String>
    -Policy <PolicyIdParameter>
    [-ContentContainsSensitiveInformation <PswsHashtable[]>]
    [-Confirm]
    [-ContentMatchQuery <String>]
    [-ExpirationDateOption <String>]
    [-IRMRiskyUserProfiles <String>]
    [-MachineLearningModelIDs <MultiValuedProperty>]
    [-PriorityCleanup]
    [-RetentionComplianceAction <String>]
    [-WhatIf]
    [<CommonParameters>]

Default

New-RetentionComplianceRule
    [-Name] <String>
    -Policy <PolicyIdParameter>
    [-Comment <String>]
    [-ExcludedItemClasses <MultiValuedProperty>]
    [-RetentionDuration <Unlimited>]
    [-RetentionDurationDisplayHint <HoldDurationHint>]
    [-Confirm]
    [-ContentMatchQuery <String>]
    [-ExpirationDateOption <String>]
    [-PriorityCleanup]
    [-RetentionComplianceAction <String>]
    [-WhatIf]
    [<CommonParameters>]

PublishComplianceTag

New-RetentionComplianceRule
    -Policy <PolicyIdParameter>
    -PublishComplianceTag <String>
    [-Confirm]
    [-ExpirationDateOption <String>]
    [-PriorityCleanup]
    [-RetentionComplianceAction <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

보존 규칙은 Policy 매개 변수를 사용하여 기존 보존 정책에 추가해야 합니다. 각 보존 정책에는 하나의 규칙만 추가할 수 있습니다.

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

예제

예 1

New-RetentionComplianceRule -Name InternalCompanyRule -Policy "Internal Company Policy" -RetentionDuration Unlimited

이 예제에서는 InternalCompanyRule이라는 새 사례 보존 규칙을 만들고 "내부 회사 정책"이라는 기존 사례 보존 정책에 추가합니다. 콘텐츠는 무기한 보존됩니다.

예 2

New-RetentionComplianceRule -Name SeptOneYear -Policy "Internal Company Policy" -RetentionDuration 365 -RetentionComplianceAction KeepAndDelete -ExpirationDateOption ModificationAgeInDays

이 예제에서는 SeptOneYear라는 새 보존 규칙을 만들고 "내부 회사 정책"이라는 기존 보존 정책에 추가합니다. 콘텐츠는 콘텐츠가 삭제되기 전에 마지막으로 수정된 날부터 1년 동안 유지됩니다.

매개 변수

-ApplyComplianceTag

적용 가능: 보안 & 규정 준수

ApplyComplianceTag 매개 변수는 전자 메일 메시지 또는 문서에 콘텐츠가 보존되는 기간에 영향을 주는 규칙이 적용된 레이블을 지정합니다. 이 매개 변수에 유효한 값은 기존 레이블의 이름입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.

Get-ComplianceTag 및 New-ComplianceTag cmdlet을 사용하여 레이블을 보거나 만듭니다.

Name 또는 PublishComplianceTag 매개 변수와 함께 이 매개 변수를 사용할 수는 없습니다.

Teams 보존 규칙에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ComplianceTag
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Comment

적용 가능: 보안 & 규정 준수

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Default
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

적용 가능: 보안 & 규정 준수

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

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ContentContainsSensitiveInformation

적용 가능: 보안 & 규정 준수

ContentContainsSensitiveInformation 매개 변수는 콘텐츠의 중요한 정보 유형 일치를 기반으로 하는 규칙의 조건을 지정합니다. 이 규칙은 지정된 중요한 정보 유형이 포함된 콘텐츠에 적용됩니다.

이 매개 변수는 @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...) 기본 구문을 사용합니다. 예를 들면 @(@{Name="U.S. Social Security Number (SSN)"; minCount="2"},@{Name="Credit Card Number"})와 같습니다.

Get-DLPSensitiveInformationType cmdlet을 사용하여 조직의 중요한 정보 유형을 나열합니다. 중요한 정보 유형에 대한 자세한 내용은 Exchange의 중요한 정보 유형이 찾는 항목을 참조하세요.

이 매개 변수는 ApplyComplianceTag 매개 변수와 함께 사용할 수 있습니다.

Teams 보존 규칙에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

형식:

PswsHashtable[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ComplianceTag
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ContentMatchQuery

적용 가능: 보안 & 규정 준수

ContentMatchQuery 매개 변수는 콘텐츠 검색 필터를 지정합니다.

이 매개 변수는 텍스트 검색 문자열 또는 KQL(키워드 쿼리 언어)를 사용하여 서식이 지정된 쿼리를 사용합니다. 자세한 내용은 KQL(키워드 쿼리 언어) 구문 참조eDiscovery에 대한 키워드 쿼리 및 검색 조건을 참조하세요.

Teams 보존 규칙에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ComplianceTag
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
Default
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ExcludedItemClasses

적용 가능: 보안 & 규정 준수

ExcludedItemClasses 매개 변수는 규칙에서 제외할 메시지 유형을 지정합니다. 이 매개 변수를 사용하여 지정된 항목 클래스를 보류에서 제외하는 보류 정책에서 항목을 제외할 수 있습니다. 이 매개 변수를 사용하면 항목이 삭제 정책에서 제외되지 않습니다. 일반적으로 이 매개 변수를 사용하여 음성 메일 메시지, 메신저 대화 및 기타 비즈니스용 Skype Online 콘텐츠가 보류 정책에 의해 유지되지 않도록 제외합니다. 일반적인 비즈니스용 Skype 값은 다음과 같습니다.

  • IPM. 참고.Microsoft.Conversation
  • IPM. Note.Microsoft.Conversation.Voice
  • IPM. 참고.Microsoft.Missed
  • IPM. Note.Microsoft.Missed.Voice
  • IPM. 참고.Microsoft.Voicemail
  • IPM.Note.Microsoft.VoiceMessage.UA
  • IPM. Note.Microsoft.Voicemail.UM
  • IPM.Note.Microsoft.Voicemail.UM.CA

또한 Exchange 항목 및 사용자 지정 또는 Microsoft 이외의 메시지 클래스에 대한 메시지 클래스를 지정할 수 있습니다. 지정한 값의 유효성이 검사되지 않으므로 매개 변수는 텍스트 값을 허용합니다.

구문을 "Value1","Value2",..."ValueN"사용하여 여러 항목 클래스 값을 지정할 수 있습니다.

Teams 보존 규칙에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

형식:MultiValuedProperty
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Default
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ExpirationDateOption

적용 가능: 보안 & 규정 준수

ExpirationDateOption 매개 변수는 콘텐츠 생성 날짜 또는 마지막 수정 날짜에서 만료 날짜를 계산할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • CreationAgeInDays
  • ModificationAgeInDays

Teams 보존 규칙에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-IRMRiskyUserProfiles

적용 가능: 보안 & 규정 준수

{{ FILL IRMRiskyUserProfiles description }}

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ComplianceTag
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MachineLearningModelIDs

적용 가능: 보안 & 규정 준수

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

형식:MultiValuedProperty
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ComplianceTag
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

적용 가능: 보안 & 규정 준수

Name 매개 변수는 보존 규칙의 고유 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.

ApplyComplianceTag 또는 PublishComplianceTag 매개 변수와 함께 이 매개 변수를 사용할 수는 없습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Default
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Policy

적용 가능: 보안 & 규정 준수

Policy 매개 변수는 규칙을 포함하는 정책을 지정합니다.

매개 변수 속성

형식:PolicyIdParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-PriorityCleanup

적용 가능: 보안 & 규정 준수

PriorityCleanup 스위치는 우선 순위 정리 정책과 연결된 규칙을 만들지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

우선 순위 정리 정책은 기존 보존 설정 또는 eDiscovery 보류를 재정의하여 중요한 콘텐츠의 삭제를 신속하게 처리합니다. 자세한 내용은 우선 순위 정리를 참조하세요.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-PublishComplianceTag

적용 가능: 보안 & 규정 준수

PublishComplianceTag 매개 변수는 규칙에 대해 게시된 레이블을 지정하여 앱(예: Outlook, SharePoint 및 OneDrive)에서 사용자에게 레이블을 표시합니다. 이 매개 변수에 유효한 값은 기존 레이블의 이름입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.

Get-ComplianceTag 및 New-ComplianceTag cmdlet을 사용하여 레이블을 보거나 만듭니다.

다음 시나리오에서는 이 매개 변수를 사용할 수 없습니다.

  • Name 또는 ApplyComplianceTag 매개 변수를 사용합니다.
  • Teams 보존 규칙의 경우.
  • 클라우드 첨부 파일 정책을 사용합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

PublishComplianceTag
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-RetentionComplianceAction

적용 가능: 보안 & 규정 준수

RetentionComplianceAction 매개 변수는 규칙에 대한 보존 작업을 지정합니다. 유효한 값은 다음과 같습니다.

  • 삭제
  • 유지
  • KeepAndDelete

이 매개 변수를 사용하지 않으면 보존 정책이 "mbx" 정책 대신 "UniH" 정책으로 만들어집니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-RetentionDuration

적용 가능: 보안 & 규정 준수

RetentionDuration 매개 변수는 보존 규칙의 보존 기간을 지정합니다. 유효한 값은 다음과 같습니다.

  • 정수: 보류 기간(일)입니다.
  • 무제한: 콘텐츠는 무기한 보존됩니다.

매개 변수 속성

형식:Unlimited
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Default
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-RetentionDurationDisplayHint

적용 가능: 보안 & 규정 준수

RetentionDurationDisplayHint 매개 변수는 Microsoft Purview 규정 준수 포털 보존 기간을 표시하는 데 사용되는 단위를 지정합니다. 유효한 값은 다음과 같습니다.

  • 년 후에 삭제

예를 들어 이 매개 변수가 Year 값으로 설정되고 RetentionDuration 매개 변수가 값 365로 설정된 경우 Microsoft Purview 규정 준수 포털 콘텐츠 보존 기간으로 1년을 표시합니다.

Teams 보존 규칙에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

형식:HoldDurationHint
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Default
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

적용 가능: 보안 & 규정 준수

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.