Invoke-HoldRemovalAction
이 cmdlet은 보안 및 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 및 준수 PowerShell을 참조하세요.
Invoke-HoldRemovalAction cmdlet을 사용하여 사서함 및 SharePoint 사이트에서 보류를 보고 제거합니다. 이 cmdlet을 사용하여 이전에 제거된 보류를 볼 수도 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Invoke-HoldRemovalAction
-Action <HoldRemovalActionType>
[-Confirm]
[-ExchangeLocation <String>]
[-Force]
[-HoldId <String>]
[-SharePointLocation <String>]
[-WhatIf]
[<CommonParameters>]
Description
이 cmdlet을 사용하려면 보안 및 준수 PowerShell에서 사용 권한을 할당받아야 합니다. 준수 관리자만 Exchange 또는 Sharepoint 위치에 대한 보류를 제거할 수 있습니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.
예제
예 1
Invoke-HoldRemovalAction -Action RemoveHold -ExchangeLocation "KittyPetersen@contoso.onmicrosoft.com" -HoldId "UniHecbf89df-74fc-444a-a2dc-c0756c7d3503"
다음은 정책 UniHecbf89df-74fc-444a-a2dc-c0756c7d3503이 활성 사례 보존 정책이 아닌 경우 키티 피터슨의 사서함에서 지정된 보류를 제거하는 예제입니다.
예 2
Invoke-HoldRemovalAction -Action GetHolds -SharePointLocation "https://contoso.sharepoint.com/sites/finance"
다음은 지정한 SharePoint 사이트의 모든 보존 정보를 표시하는 예제입니다.
예 3
Invoke-HoldRemovalAction -Action GetHoldRemovals
이 예제에서는 이 cmdlet을 사용하여 수행된 모든 보류 제거를 표시합니다.
매개 변수
-Action
적용 가능: 보안 & 규정 준수
Action 매개 변수는 cmdlet이 작동하는 모드를 지정합니다. 유효한 값은 다음과 같습니다.
- GetHoldRemovals: 이 cmdlet을 사용하여 수행된 모든 보류 제거를 표시합니다.
- GetHolds: 지정된 사서함(ExchangeLocation 매개 변수) 또는 SharePoint 사이트(SharePointLocation 매개 변수)에 대한 보류를 표시합니다.
- RemoveHold: 지정된 사서함(ExchangeLocation 매개 변수) 또는 SharePoint 사이트(SharePointLocation 매개 변수)에서 지정된 보류(HoldId 매개 변수)를 제거합니다.
매개 변수 속성
| 형식: | HoldRemovalActionType |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | 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(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ExchangeLocation
적용 가능: 보안 & 규정 준수
ExchangeLocation 매개 변수는 보거나 제거할 보류가 포함된 사서함의 이메일 주소를 지정합니다.
이 매개 변수는 Action 매개 변수에 대해 GetHolds 또는 RemoveHold 값을 사용할 때 필요합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Force
적용 가능: 보안 & 규정 준수
강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치를 사용하여 정책이 활성화된 경우에도 보류를 강제로 제거할 수 있습니다. 대신 사례 보존 정책에서 보류를 제거해야 합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-HoldId
적용 가능: 보안 & 규정 준수
HoldId 매개 변수는 보거나 제거할 보류를 지정합니다.
이 매개 변수에 대한 유효한 값을 찾으려면 Action 매개 변수 값 GetHolds와 함께 이 cmdlet을 사용하고 출력에서 HoldId 속성을 찾습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SharePointLocation
적용 가능: 보안 & 규정 준수
SharePointLocation 매개 변수는 보거나 제거할 보류가 포함된 SharePoint 사이트의 URL을 지정합니다.
이 매개 변수는 Action 매개 변수에 대해 GetHolds 또는 RemoveHold 값을 사용할 때 필요합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
적용 가능: 보안 & 규정 준수
WhatIf 스위치는 보안 및 준수 PowerShell에서 작동하지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.