다음을 통해 공유

Restore-Mailbox

  • 참조
모듈:
ExchangePowerShell
적용 대상:
Exchange Server 2010

이 cmdlet은 Exchange Server 2010년에만 사용할 수 있습니다.

Restore-Mailbox cmdlet을 사용하여 복원된 데이터베이스에서 사서함 콘텐츠를 추출합니다.

참고: Exchange Server 2010 SP1(서비스 팩 1) 이상에서는 Restore-Mailbox cmdlet 대신 New-MailboxRestoreRequest cmdlet을 사용하여 복원된 데이터베이스에서 사서함 콘텐츠를 추출합니다.

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

Syntax

Restore-Mailbox
       [-Identity] <MailboxIdParameter>
       -RecoveryDatabase <DatabaseIdParameter>
       -RecoveryMailbox <StoreMailboxIdParameter>
       -TargetFolder <String>
       [-AllowDuplicates]
       [-AllContentKeywords <String[]>]
       [-AttachmentFilenames <String[]>]
       [-BadItemLimit <Int32>]
       [-Confirm]
       [-ContentKeywords <String[]>]
       [-EndDate <DateTime>]
       [-ExcludeFolders <MapiFolderPath[]>]
       [-GlobalCatalog <Fqdn>]
       [-IncludeFolders <MapiFolderPath[]>]
       [-Locale <CultureInfo>]
       [-MaxThreads <Int32>]
       [-RecipientKeywords <String[]>]
       [-SenderKeywords <String[]>]
       [-StartDate <DateTime>]
       [-SubjectKeywords <String[]>]
       [-ValidateOnly]
       [-WhatIf]
       [<CommonParameters>]

Description

Restore-Mailbox cmdlet은 Microsoft Exchange Server 2010을 실행하는 모든 서버의 최종 사용자 데이터를 사서함을 지원하기에 충분한 공간과 리소스가 있는 동일한 조직의 Exchange 2010 사서함 서버의 사서함에 복사합니다. Restore-Mailbox cmdlet은 서버에서 연결이 끊긴 사서함만 데이터 원본으로 사용할 수 있으며 cmdlet은 연결된 사서함만 데이터의 대상으로 사용할 수 있습니다.

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

예제

예 1

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase

다음은 MyRecoveryDatabase 데이터베이스에서 사용자 Scott의 사서함을 복원하는 예제입니다.

예 2

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery

다음은 John의 사서함 콘텐츠를 Recovery 폴더 아래의 Scott 사서함으로 복원하는 예제입니다.

예 3

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar

다음은 비즈니스라는 단어가 포함된 메시지 본문과 받은 편지함 또는 일정 폴더의 메시지 위치와 함께 모임이라는 제목의 메일만 복원하는 예제입니다. 이 예제에서는 사서함이 영어로되어 있다고 가정합니다.

예 4

Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase

다음은 MyRecoveryDatabase에도 있는 MyDatabase 사서함 데이터베이스의 모든 사서함을 대량 복원하는 예제입니다.

매개 변수

-AllContentKeywords

AllContentKeywords 매개 변수는 다음의 모든 필터를 지정합니다.

  • 제목
  • 메시지 본문
  • 첨부 파일 콘텐츠

이렇게 하면 이러한 모든 필드를 OR로 검색할 수 있습니다. 검색 조건이 제목, 메시지 본문 또는 첨부 파일 콘텐츠의 일부인 경우 결과를 얻습니다.

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

-AllowDuplicates

AllowDuplicates 스위치는 중복된 항목을 제거하지 않고 기존 항목의 중복 여부를 확인하지 않고 메일 항목을 복사합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

IncludeFolders 매개 변수와 함께 이 스위치를 사용하는 것이 좋습니다.

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

-AttachmentFilenames

AttachmentFilenames 매개 변수는 첨부 파일 이름에 대한 필터를 지정합니다. 문자열에서 와일드카드 문자를 사용할 수 있습니다. 예를 들어 *.txt 사용하여 .txt 확장이 있는 항목을 내보낼 수 있습니다.

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

-BadItemLimit

BadItemLimit 매개 변수는 내보내기 작업이 실패하기 전에 건너뛸 사서함의 손상된 항목 수를 지정합니다.

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

-Confirm

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

  • 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
  • 대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ContentKeywords

ContentKeywords 매개 변수는 원본 사서함에 있는 첨부 파일의 메시지 본문 및 콘텐츠에 대한 키워드 필터를 지정합니다.

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

-EndDate

EndDate 매개 변수는 원본 사서함에서 내보낼 콘텐츠를 필터링하기 위한 종료 날짜를 지정합니다. 종료 날짜 이전의 날짜가 있는 사서함의 항목만 내보냅니다. 특정 날짜를 입력할 때 로컬 컴퓨터에 구성된 국가별 옵션 설정에 정의된 짧은 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 mm/dd/yyyy를 사용하도록 구성된 경우 2010년 3월 1일을 지정하려면 2010년 3월 1일을 입력합니다.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ExcludeFolders

ExcludeFolders 매개 변수는 내보내는 동안 제외할 폴더 목록을 지정합니다. 폴더는 입력될 때 제외됩니다. 지역화되지 않습니다. 예를 들어 다른 언어의 달력은 다른 단어이므로 달력을 제외하면 영어로 된 달력만 제외됩니다.

Type:MapiFolderPath[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-GlobalCatalog

GlobalCatalog 매개 변수는 대상 사서함을 검색하는 데 사용할 글로벌 카탈로그를 지정합니다.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Identity

Identity 매개 변수는 복원하려는 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • Domain\Username
  • 전자 메일 주소
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 사용자 ID 또는 UPN(사용자 계정 이름)
Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IncludeFolders

IncludeFolders 매개 변수는 내보내는 동안 포함할 폴더 목록을 지정합니다. 폴더는 입력될 때 포함됩니다. 지역화되지 않습니다. 예를 들어 다른 언어의 달력은 다른 단어이므로 달력을 포함하려면 영어 달력만 포함됩니다.

Type:MapiFolderPath[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Locale

Locale 매개 변수는 복원할 메시지의 로캘 설정을 지정합니다. 이 필터를 설정하면 지정된 로캘 설정이 있는 메시지만 추출됩니다.

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MaxThreads

MaxThreads 매개 변수는 사용할 최대 스레드 수를 지정합니다.

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

-RecipientKeywords

RecipientKeywords 매개 변수는 원본 사서함에 있는 항목의 받는 사람에 대한 키워드 필터를 지정합니다. 이 필터는 단어의 일부인 경우에도 검색 문자열을 찾습니다. 이것은 전체 단어 검색이 아닙니다.

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

-RecoveryDatabase

RecoveryDatabase 매개 변수는 사서함을 복원할 복구 데이터베이스를 지정합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름
  • DN(고유 이름)
  • GUID
Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RecoveryMailbox

RecoveryMailbox 매개 변수는 원본 사서함으로 사용할 사서함을 지정합니다. 원본 사서함이 대상 사서함과 다른 경우 이 매개 변수가 필요합니다.

사서함을 GUID 값으로 식별합니다. Get-Mailbox 또는 Get-MailboxStatistics cmdlet을 사용하여 GUID 값을 찾을 수 있습니다.

Type:StoreMailboxIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-SenderKeywords

SenderKeywords 매개 변수는 원본 사서함에 있는 항목의 보낸 사람의 키워드 필터를 지정합니다. 이 필터는 단어의 일부인 경우에도 검색 문자열을 찾습니다. 이것은 전체 단어 검색이 아닙니다.

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

-StartDate

StartDate 매개 변수는 시작 날짜를 지정합니다. 시작 날짜는 종료 날짜 이전이어야 합니다.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-SubjectKeywords

SubjectKeywords 매개 변수는 원본 사서함에 있는 항목의 주체에 대한 키워드 필터를 지정합니다. 이 필터는 단어의 일부인 경우에도 검색 문자열을 찾습니다. 이것은 전체 단어 검색이 아닙니다.

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

-TargetFolder

TargetFolder 매개 변수는 지정된 사서함에 생성된 사서함 폴더를 지정합니다. 복원 중인 사서함이 대상 사서함과 다른 경우 이 매개 변수가 필요합니다. 예를 들어 Identity 매개 변수로 지정된 값은 RecoveryMailbox 매개 변수로 지정된 값과 다릅니다. 이 경우 Restore-Mailbox 명령은 병합을 수행합니다. 값이 같으면 TargetFolder 매개 변수가 필요하지 않습니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ValidateOnly

ValidateOnly 스위치는 명령에 작업을 수행하는 데 필요한 조건 및 요구 사항을 평가한 다음 작업이 성공할지 아니면 실패할지 보고하도록 지시합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용할 때는 변경되지 않습니다.

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

-WhatIf

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

입력

Input types

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

출력

Output types

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.