다음을 통해 공유


New-HoldComplianceRule

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

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

참고: New-HoldComplianceRule cmdlet이 New-RetentionComplianceRule cmdlet으로 대체되었습니다. New-HoldComplianceRule을 사용하는 스크립트가 있는 경우 New-RetentionComplianceRule을 사용하도록 업데이트합니다.

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

Syntax

New-HoldComplianceRule
   [-Name] <String>
   -Policy <PolicyIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-ContentDateFrom <DateTime>]
   [-ContentDateTo <DateTime>]
   [-ContentMatchQuery <String>]
   [-Disabled <Boolean>]
   [-HoldContent <Unlimited>]
   [-HoldDurationDisplayHint <HoldDurationHint>]
   [-WhatIf]
   [<CommonParameters>]

Description

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

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

예제

예 1

New-HoldComplianceRule -Name SeptOneYear -Policy "Internal Company Policy" -ContentDateFrom "09/10/14 5:00 PM" -ContentDateTo "09/10/15 5:00 PM" -HoldContent Unlimited

이 예제에서는 SeptOneYear라는 새 보존 규칙을 만들고 "내부 회사 정책"이라는 기존 보존 정책에 추가합니다. 지정된 날짜 사이에 만들어졌거나 업데이트된 콘텐츠는 무기한 보관됩니다.

매개 변수

-Comment

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

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

-ContentDateFrom

ContentDateFrom 매개 변수는 포함할 콘텐츠에 대한 날짜 범위의 시작 날짜를 지정합니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

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

-ContentDateTo

ContentDateTo 매개 변수는 포함할 콘텐츠에 대한 날짜 범위의 종료 날짜를 지정합니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

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

-ContentMatchQuery

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

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

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

-Disabled

Disabled 매개 변수는 보존 규칙을 사용할지 여부를 지정합니다. 이 매개 변수에는 $true 또는 $false을 입력할 수 있습니다. 기본값은 $false.

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

-HoldContent

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

  • 정수: 보류 기간(일)입니다.
  • 무제한: 콘텐츠는 무기한 보존됩니다.
Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-HoldDurationDisplayHint

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

  • 년 후에 삭제

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

Type:HoldDurationHint
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

-Policy

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

Type:PolicyIdParameter
Position:Named
Default value:None
Required:True
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