Set-CaseHoldPolicy
이 cmdlet은 보안 및 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 및 준수 PowerShell을 참조하세요.
Set-CaseHoldPolicy cmdlet을 사용하여 Microsoft Purview 규정 준수 포털의 기존 케이스 보류 정책을 수정합니다.
참고: 이 cmdlet을 실행하면 organization 전체에서 완전히 동기화되므로 중요한 작업입니다. 여러 정책을 업데이트해야 하는 경우 정책 배포가 성공할 때까지 기다렸다가 다음 정책에 대해 cmdlet을 다시 실행합니다. 정책을 여러 번 업데이트해야 하는 경우 cmdlet을 한 번 호출하여 모든 변경을 수행합니다. 배포 상태에 대한 자세한 내용은 Get-CaseHoldPolicy를 참조하세요.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
RetryDistribution
Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-RetryDistribution]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Identity
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
이 cmdlet을 사용하려면 보안 및 준수 PowerShell에서 사용 권한을 할당받아야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.
참고: scope 위치를 추가하거나 제거할 때 파이프된 Foreach-Object 명령을 사용하지 마십시오. "Value1","Value2",..."ValueN" | Foreach-Object {Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}
예제
예 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 사이트를
https://contoso.sharepoint.com/sites/teams/finance추가합니다. - 공용 폴더를 제거합니다.
- 메모를 업데이트합니다.
매개 변수
-AddExchangeLocation
적용 대상: 보안 & 규정 준수
AddExchangeLocation 매개 변수는 포함된 사서함 목록에 추가할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.
- ExchangeLocation 매개 변수는 정책에 포함할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
- 사서함
사서함 또는 메일 그룹을 지정하려면 다음 값을 사용할 수 있습니다.
- 이름
- SMTP 주소입니다. 비활성 사서함을 지정하려면 주소 앞에 마침표(.)를 붙입니다.
- Microsoft Entra ObjectId. Microsoft Graph PowerShell에서 Get-MgUser 또는 Get-MgGroup cmdlet을 사용하여 이 값을 찾습니다.
Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AddPublicFolderLocation
적용 대상: 보안 & 규정 준수
AddPublicFolderLocation 매개 변수는 케이스 보류 정책에 모든 공용 폴더를 추가하도록 지정합니다. 이 매개 변수에는 All 값을 사용합니다.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AddSharePointLocation
적용 대상: 보안 & 규정 준수
AddSharePointLocation 매개 변수는 SharePointLocation 매개 변수에 모두 값을 사용하지 않을 때 포함된 사이트 목록에 추가할 SharePoint 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.
Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"
SharePoint 사이트는 인덱싱될 때까지 정책에 추가할 수 없습니다.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Comment
적용 대상: 보안 & 규정 준수
Comment 매개 변수는 설명(선택 사항)을 지정합니다. 공백이 포함된 값을 지정하는 경우 값을 큰따옴표(")로 묶어야 합니다(예: “이는 관리자 정보입니다”).
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| 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 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Enabled
적용 대상: 보안 & 규정 준수
Enabled 매개 변수는 정책을 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 정책을 사용하도록 설정되었습니다. 이 값이 기본값입니다.
- $true: 이 정책은 사용하도록 설정되어 있습니다. 이 값은 기본값입니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Force
적용 대상: 보안 & 규정 준수
강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 대상: 보안 & 규정 준수
Identity 매개 변수는 수정할 케이스 보류 정책을 지정합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- 이름
- DN(고유 이름)
- GUID
매개 변수 속성
| 형식: | PolicyIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-RemoveExchangeLocation
적용 대상: 보안 & 규정 준수
RemoveExchangeLocation 매개 변수는 정책에서 제거할 기존 사서함을 지정합니다. 유효한 값은 다음과 같습니다.
- All 매개 변수는 ExchangeLocation 값을 사용할 때 제외된 사서함 목록에서 제거할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
- 사서함
모든 사서함에 대해 값 All입니다. 이 값만 사용할 수 있습니다.
- 이름
- SMTP 주소입니다. 비활성 사서함을 지정하려면 주소 앞에 마침표(.)를 붙입니다.
- Microsoft Entra ObjectId. Microsoft Graph PowerShell에서 Get-MgUser 또는 Get-MgGroup cmdlet을 사용하여 이 값을 찾습니다.
Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RemovePublicFolderLocation
적용 대상: 보안 & 규정 준수
RemovePublicFolderLocation 매개 변수는 케이스 보류 정책에서 모든 공용 폴더를 제거하도록 지정합니다. 이 매개 변수에는 All 값을 사용합니다.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RemoveSharePointLocation
적용 대상: 보안 & 규정 준수
RemoveSharePointLocation 매개 변수는 SharePointLocation 매개 변수에 모두 값을 사용하지 않는 경우 포함된 사이트 목록에서 제거할 SharePoint 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.
Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RetryDistribution
적용 대상: 보안 & 규정 준수
RetryDistribution 스위치는 모든 Exchange Online 및 SharePoint 위치에 정책을 재배포할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
초기 배포가 성공적으로 수행된 위치는 다시 시도에 포함되지 않습니다. 이 스위치를 사용하는 경우 정책 배포 오류가 보고됩니다.
참고: 배포를 재시도하는 프로세스는 중요한 작업이므로 필요한 경우에만 한 번에 하나의 정책에 대해 실행합니다. 정책을 업데이트할 때마다 실행되도록 의도되지 않았습니다. 스크립트를 실행하여 여러 정책을 업데이트하는 경우 정책 배포가 성공할 때까지 기다렸다가 다음 정책에 대해 명령을 다시 실행합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
RetryDistribution
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
적용 대상: 보안 & 규정 준수
WhatIf 스위치는 보안 및 준수 PowerShell에서 작동하지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | wi |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable과 같은 일반 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.