Set-CaseHoldPolicy

참조

모듈:: ExchangePowerShell

적용 대상:: Security & Compliance

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

Set-CaseHoldPolicy cmdlet을 사용하여 Microsoft Purview 규정 준수 포털 기존 사례 보존 정책을 수정합니다.

참고: 이 cmdlet을 실행하면 organization 전체 동기화가 수행되며 이는 중요한 작업입니다. 여러 정책을 업데이트해야 하는 경우 정책 배포가 성공할 때까지 기다렸다가 cmdlet을 다시 실행하여 다음 정책을 실행합니다. 정책을 여러 번 업데이트해야 하는 경우 cmdlet의 단일 호출에서 모든 변경 내용을 적용합니다. 배포 상태 대한 자세한 내용은 Get-CaseHoldPolicy를 참조하세요.

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

Syntax

Set-CaseHoldPolicy
   [-Identity] <PolicyIdParameter>
   [-RetryDistribution]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Set-CaseHoldPolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddPublicFolderLocation <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemovePublicFolderLocation <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

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

참고: scope 위치를 "Value1","Value2",..."ValueN" | Foreach-Object {Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}추가하거나 제거할 때는 파이프된 Foreach-Object 명령을 사용하지 마세요.

예제

예 1

Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"

이 예제에서는 "Regulation 123 Compliance"라는 기존 케이스 보류 정책을 다음과 같이 변경합니다.

Kitty Petersen 사용자의 사서함에 추가합니다.
SharePoint Online 사이트 https://contoso.sharepoint.com/sites/teams/finance를 추가합니다.
공용 폴더를 제거합니다.
메모를 업데이트합니다.

매개 변수

-AddExchangeLocation

AddExchangeLocation 매개 변수는 포함된 사서함 목록에 추가할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

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

-AddPublicFolderLocation

AddPublicFolderLocation 매개 변수는 케이스 보류 정책에 모든 공용 폴더를 추가하도록 지정합니다. 이 매개 변수에는 All 값을 사용합니다.

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

-AddSharePointLocation

AddSharePointLocation 매개 변수는 SharePointLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사이트 목록에 추가할 SharePoint Online 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

SharePoint Online 사이트는 인덱싱될 때까지 정책에 추가할 수 없습니다.

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

-Force

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

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

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

-Identity

Identity 매개 변수는 수정할 케이스 보류 정책을 지정합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

이름
DN(고유 이름)
GUID

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

-RemoveExchangeLocation

RemoveExchangeLocation 매개 변수는 정책에서 제거할 기존 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

All 매개 변수는 ExchangeLocation 값을 사용할 때 제외된 사서함 목록에서 제거할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
사서함

모든 사서함에 대해 값 All입니다. 이 값만 사용할 수 있습니다.

이름
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

-RemovePublicFolderLocation

RemovePublicFolderLocation 매개 변수는 케이스 보류 정책에서 모든 공용 폴더를 제거하도록 지정합니다. 이 매개 변수에는 All 값을 사용합니다.

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

-RemoveSharePointLocation

RemoveSharePointLocation 매개 변수는 SharePointLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사이트 목록에서 제거할 SharePoint Online 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

-RetryDistribution

RetryDistribution 스위치는 정책을 모든 Exchange Online 및 SharePoint Online 위치에 재배포할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

초기 배포가 성공적으로 수행된 위치는 다시 시도에 포함되지 않습니다. 이 스위치를 사용하는 경우 정책 배포 오류가 보고됩니다.

참고: 배포를 다시 시도하는 프로세스는 중요한 작업이므로 필요한 경우에만 한 번에 하나의 정책에 대해 실행합니다. 정책을 업데이트할 때마다 실행되지 않습니다. 여러 정책을 업데이트하는 스크립트를 실행하는 경우 정책 배포가 성공할 때까지 기다렸다가 명령을 다시 실행하여 다음 정책을 실행합니다.

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

Set-CaseHoldPolicy

Syntax

Description

예제

예 1

매개 변수

-AddExchangeLocation

-AddPublicFolderLocation

-AddSharePointLocation

-Comment

-Confirm

-Enabled

-Force

-Identity

-RemoveExchangeLocation

-RemovePublicFolderLocation

-RemoveSharePointLocation

-RetryDistribution

-WhatIf

피드백

피드백

추가 리소스