Invoke-HoldRemovalAction

모듈:: ExchangePowerShell

적용 대상:: Security & Compliance

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

Invoke-HoldRemovalAction cmdlet을 사용하여 사서함 및 SharePoint 사이트에서 보류를 보고 제거합니다. 이 cmdlet을 사용하여 이전에 제거된 보류를 볼 수도 있습니다.

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

구문

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
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-Confirm

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-ExchangeLocation

ExchangeLocation 매개 변수는 보거나 제거할 보류가 포함된 사서함의 이메일 주소를 지정합니다.

이 매개 변수는 Action 매개 변수에 대해 GetHolds 또는 RemoveHold 값을 사용할 때 필요합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-Force

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

이 스위치를 사용하여 정책이 활성화된 경우에도 보류를 강제로 제거할 수 있습니다. 대신 사례 보존 정책에서 보류를 제거해야 합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-HoldId

HoldId 매개 변수는 보거나 제거할 보류를 지정합니다.

이 매개 변수에 대한 유효한 값을 찾으려면 Action 매개 변수 값 GetHolds와 함께 이 cmdlet을 사용하고 출력에서 HoldId 속성을 찾습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-SharePointLocation

SharePointLocation 매개 변수는 보거나 제거할 보류가 포함된 SharePoint 사이트의 URL을 지정합니다.