New-CaseHoldPolicy

참조

모듈:: ExchangePowerShell

적용 대상:: Security & Compliance

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

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

New-CaseHoldPolicy cmdlet을 사용하여 사례 보존 정책을 만든 후에는 New-CaseHoldRule cmdlet을 사용하여 사례 보존 규칙을 만들고 정책에 규칙을 할당해야 합니다. 정책에 대한 규칙을 만들지 않으면 보류가 만들어지지 않고 콘텐츠 위치가 보류되지 않습니다.

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

Syntax

New-CaseHoldPolicy
   [-Name] <String>
   -Case <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-Force]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

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

예제

예 1

New-CaseHoldPolicy -Name "Regulation 123 Compliance" -Case "123 Compliance Case" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

이 예제에서는 Kitty Petersen 및 Scott Nakamura의 사서함에 대해 "규정 123 규정 준수"라는 사례 보존 정책과 "123 준수 사례"라는 eDiscovery 사례에 대한 금융 SharePoint Online 사이트를 만듭니다.

정책을 만든 후에는 New-CaseHoldRule cmdlet을 사용하여 정책에 대한 규칙을 만들어야 합니다.

매개 변수

-Case

Case 매개 변수는 사례 보존 정책과 연결하려는 eDiscovery 사례를 지정합니다. 다음 값을 사용하여 eDiscovery 케이스를 식별할 수 있습니다.

이름
ID(GUID 값)

Get-ComplianceCase | Format-Table -Auto Name,Status,Identity 명령을 실행하여 이러한 값을 찾을 수 있습니다.

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

-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

-Enabled

Enabled 매개 변수는 정책을 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 정책이 활성화되어 있습니다. 이 값은 기본값입니다.
$true: 이 정책은 사용하도록 설정되어 있습니다. 이 값은 기본값입니다.

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

-ExchangeLocation

ExchangeLocation 매개 변수는 정책에 포함할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

ExchangeLocation 매개 변수는 정책에 포함할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
사서함

사서함 또는 메일 그룹을 지정하려면 다음 값을 사용할 수 있습니다.

이름
SMTP 주소입니다. 비활성 사서함을 지정하려면 주소 앞에 마침표(.)를 지정합니다.
ObjectId를 Azure AD. 이 값을 찾으려면 Microsoft Graph PowerShell의 Get-MgUser 또는 Get-MgGroup cmdlet을 사용합니다.

Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.

지정된 사서함이 없는 경우 사서함이 보류되지 않습니다.

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

-Name

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

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

-PublicFolderLocation

PublicFolderLocation 매개 변수는 사례 보존 정책에 모든 공용 폴더를 포함하도록 지정합니다. 이 매개 변수에는 All 값을 사용합니다.

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

-SharePointLocation

SharePointLocation 매개 변수는 포함할 SharePoint Online 및 비즈니스용 OneDrive 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.