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 |