다음을 통해 공유

Get-RecoverableItems

  • 참조
모듈:
ExchangePowerShell
적용 대상:
Exchange Server 2016, Exchange Server 2019, Exchange Online

cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

Get-RecoverableItems 항목 cmdlet을 사용하여 사서함에서 삭제된 항목을 봅니다. 삭제된 항목을 찾은 후 Restore-RecoverableItems cmdlet을 사용해 삭제된 항목을 복구합니다.

이 cmdlet은 사서함 가져오기 내보내기 역할에서만 사용할 수 있으며 기본적으로 역할은 역할 그룹에 할당되지 않습니다. 이러한 cmdlet을 사용하려면 역할 그룹(예: Organization Management 역할 그룹)에 사서함 가져오기 내보내기 역할을 추가해야 합니다. 자세한 내용은 역할 그룹에 역할 추가를 참조하세요.

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

Syntax

Get-RecoverableItems
   -Identity <GeneralMailboxOrMailUserIdParameter>
   [-EntryID <String>]
   [-FilterEndTime <DateTime>]
   [-FilterItemType <String>]
   [-FilterStartTime <DateTime>]
   [-LastParentFolderID <String>]
   [-ResultSize <Unlimited>]
   [-SourceFolder <RecoverableItemsFolderType>]
   [-SubjectContains <String>]
   [<CommonParameters>]
Get-RecoverableItems
   -Identity <GeneralMailboxOrMailUserIdParameter[]>
   [-EntryID <String>]
   [-FilterEndTime <DateTime>]
   [-FilterItemType <String>]
   [-FilterStartTime <DateTime>]
   [-LastParentFolderID <String>]
   [-MaxParallelSize <Int32>]
   [-PolicyTag <String[]>]
   [-ResultSize <Unlimited>]
   [-SourceFolder <RecoverableItemsFolderType>]
   [-SubjectContains <String>]
   [<CommonParameters>]

Description

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Get-RecoverableItems -Identity laura@contoso.com -SubjectContains "FY17 Accounting" -FilterItemType IPM.Note -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"

이 예제에서는 지정된 날짜/시간 범위에 대해 사서함 laura@contoso.com 에 지정된 주체가 있는 사용 가능한 복구 가능한 삭제된 메시지를 모두 반환합니다.

예 2

Get-RecoverableItems -Identity "malik@contoso.com", "lillian@contoso.com" -FilterItemType IPM.Note -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM"

다음은 지정된 날짜/시간 범위의 사서함에 지정된 주체와 함께 사용 가능한 복구 가능한 삭제된 메시지를 모두 malik@contoso.comlillian@contoso.com 반환하는 예제입니다.

매개 변수

-EntryID

EntryID 매개 변수는 복원하려는 삭제된 항목을 지정합니다. 삭제된 항목의 EntryID 값은 사서함에서 고유합니다.

Get-RecoverableItems cmdlet(제목, 날짜 범위 등)에서 다른 검색 필터를 사용하여 특정 항목에 대한 EntryID를 찾을 수 있습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterEndTime

FilterEndTime은 날짜 범위의 종료 날짜/시간을 지정합니다. 이 매개 변수는 항목의 LastModifiedTime 값을 사용합니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterItemType

FilterItemType 매개 변수는 삭제된 항목의 지정된 MessageClass(ItemClass) 속성 값으로 결과를 필터링합니다. 예를 들면

  • Ipm. 약속(모임 및 약속)
  • Ipm. 연락처
  • Ipm. 파일
  • Ipm. 참고
  • Ipm. 작업
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterStartTime

FilterStartTime은 날짜 범위의 시작 날짜/시간을 지정합니다. 이 매개 변수는 항목의 LastModifiedTime 값을 사용합니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Identity 매개 변수는 보려는 삭제된 항목이 포함된 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • Domain\Username
  • 전자 메일 주소
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 사용자 ID 또는 UPN(사용자 계정 이름)

Exchange Online 쉼표로 구분된 여러 사서함을 지정할 수 있습니다. 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.

Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-LastParentFolderID

LastParentFolderID 매개 변수는 삭제되기 전에 항목의 FolderID 값을 지정합니다. 예를 들어 53B93149989CA54DBC9702AE619B9CCA000062CE9397입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-MaxParallelSize

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

MaxParallelSize 매개 변수는 명령에서 병렬로 처리되는 최대 사서함 수를 지정합니다. 유효한 값은 1에서 10까지의 정수입니다. 일반적으로 값이 높을수록 여러 사서함에서 명령을 완료하는 데 걸리는 시간이 줄어듭니다.

Identity 매개 변수가 하나의 사서함만 지정하는 경우 이 매개 변수의 값은 적용되지 않습니다.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PolicyTag

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

{{ Fill PolicyTag Description }}

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1,000입니다.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceFolder

SourceFolder 매개 변수는 사서함에서 삭제된 항목을 검색할 위치를 지정합니다. 유효한 값은 다음과 같습니다.

  • DeletedItems: 지운 편지함 폴더입니다.

  • RecoveryableItems: 복구 가능한 항목\삭제 폴더입니다. 이 폴더에는 삭제된 항목 폴더(일시 삭제된 항목)에서 삭제된 항목이 포함됩니다.

  • PurgedItems: 복구 가능한 항목\제거 폴더입니다. 이 폴더에는 복구 가능한 항목 폴더(하드 삭제된 항목)에서 제거된 항목이 포함됩니다.

    이 매개 변수를 사용하지 않으면 명령은 이러한 세 폴더를 검색합니다.

  • DiscoveryHoldsItems: 복구 가능한 항목\DiscoveryHolds 폴더입니다. 이 폴더에는 복구 가능한 항목 폴더(하드 삭제된 항목)에서 제거되고 보류로 보호되는 항목이 포함됩니다. 이 폴더에서 삭제된 항목을 검색하려면 DiscoveryHoldsItems 값과 함께 이 매개 변수를 사용합니다.

Type:RecoverableItemsFolderType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SubjectContains

SubjectContains 매개 변수는 제목 필드에서 지정된 텍스트 값으로 항목을 필터링합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online