Restore-RecoverableItems

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Restore-RecoverableItems 항목 cmdlet을 사용하여 사서함에서 삭제된 항목을 복원합니다. Get-RecoverableItems cmdlet을 사용하여 복구할 삭제된 항목을 찾습니다.

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

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

Syntax

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

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

Description

항목에 대한 정보를 사용할 수 있는 경우 항목이 원래 폴더 위치로 복원됩니다. 정보를 찾을 수 없는 경우 항목 유형(메시지의 받은 편지함, 모임 및 약속의 일정 등)에 대한 기본 폴더로 항목이 복원됩니다.

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

예제

예 1

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

Get-RecoverableItems cmdlet을 사용하여 항목의 존재를 확인한 후 이 예제에서는 지정된 사서함에서 지정된 삭제된 항목을 복원합니다.

사서함: laura@contoso.com
항목 유형: Email 메시지
메시지 제목: FY18 회계
위치: 복구 가능한 항목\삭제
날짜 범위: 2018년 2월 1일~2018년 2월 5일

예 2

$mailboxes = Import-CSV "C:\My Documents\RestoreMessage.csv"

$mailboxes | foreach {Restore-RecoverableItems -Identity $_.SMTPAddress -SubjectContains "Project X" -SourceFolder DeletedItems -FilterItemType IPM.Note}

Exchange Server 이 예제에서는 CSV(쉼표로 구분된 값) 파일 C:\My Documents\RestoreMessage.csv 지정된 사서함에 대해 삭제된 전자 메일 메시지 "Project X"를 복원합니다. CSV 파일은 헤더 값 SMTPAddress를 사용하며 다음과 같은 별도의 줄에 각 사서함의 이메일 주소를 포함합니다.

SMTPAddress

chris@contoso.com

michelle@contoso.com

laura@contoso.com

julia@contoso.com

첫 번째 명령은 CSV 파일을 $mailboxes 변수로 읽습니다. 두 번째 명령은 해당 사서함의 지운 편지함 폴더에서 지정된 메시지를 복원합니다.

예 3

Restore-RecoverableItems -Identity "malik@contoso.com","lillian@contoso.com" -FilterItemType IPM.Note -SubjectContains "COGS FY17 Review" -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM" -MaxParallelSize 2

Exchange Online Get-RecoverableItems cmdlet을 사용하여 항목의 존재를 확인한 후 이 예제에서는 지정된 사서함에서 지정된 삭제된 항목을 복원합니다.

사서함: malik@contoso.com, lillian@contoso.com
항목 유형: Email 메시지
메시지 제목: COGS FY17 검토
위치: 복구 가능한 항목\삭제
날짜 범위: 2019/3/15~2019/3/25
동시에 처리된 사서함 수: 2

예 4

Get-RecoverableItems administrator | Restore-RecoverableItems

다음은 관리자를 위해 복구 가능한 모든 항목을 대량 복원하는 예제입니다.

매개 변수

-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 값을 사용합니다.

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

-NoOutput

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

NoOutput 스위치는 콘솔에서 명령 출력 없이 삭제된 항목을 직접 복원합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-PolicyTag

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

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

-RestoreTargetFolder

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

RestoreTargetFolder 매개 변수는 데이터를 복원할 최상위 폴더를 지정합니다. 이 매개 변수를 지정하지 않으면 명령은 대상 사서함 또는 보관 파일에서 폴더 구조의 맨 위로 폴더를 복원합니다. 내용은 기존 폴더에서 병합되며 대상 폴더 구조에 없는 폴더는 새로 생성됩니다.

이 매개 변수는 보관에 필요하며 기본 사서함의 경우 선택 사항입니다. 대상 폴더가 없으면 생성됩니다. 유효한 경로는 다음과 같습니다.

/
/folder1
/folder1/folder2
folder1
folder1/folder2

앞이나 후행 / 은 무시됩니다. 그런 다음, IPM 하위 트리 /Top Of Information Store의 상대 경로로 처리됩니다.

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
Accepted values:	DeletedItems \| RecoverableItems \| PurgedItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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

다음을 통해 공유

Restore-RecoverableItems

Syntax

Description

예제

예 1

예 2

예 3

예 4

매개 변수

-EntryID

-FilterEndTime

-FilterItemType

-FilterStartTime

-Identity

-LastParentFolderID

-MaxParallelSize

-NoOutput

-PolicyTag

-RestoreTargetFolder

-ResultSize

-SourceFolder

-SubjectContains

피드백

추가 리소스