Import-Mailbox

  • 아티클

 

적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

마지막으로 수정된 항목: 2011-06-21

Import-Mailbox cmdlet를 사용하여 .pst 파일의 사서함 데이터를 사서함으로 가져옵니다.

구문

import-Mailbox [-Identity <MailboxIdParameter>] -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

자세한 정보

Import-Mailbox cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • 대상 서버에 대한 Exchange Server 관리자 역할 및 로컬 관리자 그룹

  • 대상 사서함에 대한 모든 권한

사용 권한, 역할 위임 및 Microsoft Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

사서함에 대해 모든 권한을 부여하려면 Add-MailboxPermission cmdlet를 사용하고 AccessRights 매개 변수에 대해 FullAccess를 지정합니다.

.pst 파일에서 데이터를 가져오려면 다음이 설치된 32비트 컴퓨터에서 Import-Mailbox cmdlet를 실행해야 합니다.

  • 32비트 버전의 Exchange 관리 도구

  • Microsoft Office Outlook 2003 SP2(서비스 팩 2) 이상 버전

Exchange 2007 32비트 관리 도구 다운로드 정보에 대해서는 Microsoft Exchange Server 2007 Management Tools (32-Bit) - 한국어를 참조하십시오.

Import-Mailbox cmdlet를 사용하여 폴더나 .pst 파일로 데이터를 가져올 수 있습니다. 원본 및 대상 사서함은 다음 중 한 버전의 Exchange가 실행 중인 컴퓨터에 있어야 합니다.

  • Exchange Server 2007

  • Exchange Server 2003 SP2(서비스 팩 2) 이상 버전

  • Exchange 2000 Server SP3(서비스 팩 3) 이상 버전

.pst 파일의 데이터를 다른 버전의 Exchange에 있는 사서함으로 가져오려면 Microsoft Exchange Server Mailbox Merge Wizard (ExMerge)(영문)를 사용해야 합니다.

.pst 파일에서 Import-Mailbox cmdlet를 사용하여 데이터를 RSG(복구 저장소 그룹)에 있는 사서함으로 가져올 수 없습니다.

Import-Mailbox cmdlet를 사용하여 데이터를 공용 폴더 데이터베이스로 가져올 수 없습니다.

참고

Import-Mailbox cmdlet를 사용할 때는 MAPI 프로필을 구성하지 않아도 됩니다.

매개 변수

매개 변수 필수 종류 설명

PSTFolderPath

필수

Microsoft.Exchange.Data.LongPath

PSTFolderPath 매개 변수는 데이터를 가져올 .pst 파일의 경로를 지정합니다.

AllContentKeywords

선택

System.String[]

AllContentKeywords 매개 변수는 가져오기에 포함할 콘텐츠의 키워드를 지정합니다. 명령이 메시지 본문, 첨부 파일 내용 또는 제목에서 지정하는 키워드를 찾으면 이 명령은 이러한 메시지를 가져옵니다.

참고

이는 ContentKeywords와 SubjectKeywords 매개 변수를 모두 사용하는 것과 다릅니다. ContentKeywords와 SubjectKeywords 매개 변수를 모두 사용할 경우 명령은 메시지 본문 또는 첨부 파일 내용에서 ContentKeywords 매개 변수에 대해 지정하는 키워드와 제목에서 SubjectKeywords 매개 변수에 대해 지정하는 키워드 모두가 포함된 메시지만 가져옵니다.

AllowDuplicates

선택

System.Management.Automation.SwitchParameter

AllowDuplicates 매개 변수는 메일 항목이 기존 항목과 중복되는지 확인하지 않고 중복 항목을 제거하지 않고서 해당 메일 항목을 복사하는 데 사용됩니다. AllowDuplicates 매개 변수는 IncludeFolders 매개 변수와 함께 사용하는 것이 좋습니다.

AttachmentFilenames

선택

System.String[]

AttachmentFilenames 매개 변수는 첨부 파일 필터를 지정합니다. 문자열에 와일드카드 문자를 사용할 수 있습니다. 예를 들어, .txt 확장명을 가진 항목을 가져올 때 "*.txt"를 사용할 수 있습니다.

BadItemLimit

선택

System.Int32

BadItemLimit 매개 변수는 가져오기 작업이 실패하기 전에 .pst 파일에서 건너뛸 손상된 항목 수를 지정합니다.

Confirm

선택

System.Management.Automation.SwitchParameter

Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다.

ContentKeywords

선택

System.String[]

ContentKeywords 매개 변수는 가져오기에 포함할 콘텐츠의 키워드를 지정합니다. 명령이 메시지 본문 또는 첨부 파일 내용에서 지정하는 키워드를 찾으면 이 명령은 이러한 메시지를 가져옵니다.

EndDate

선택

System.DateTime

EndDate 매개 변수는 대상 사서함으로 가져올 내용을 필터링할 때 기준이 되는 끝 날짜를 지정합니다. .pst 파일에서 지정한 끝 날짜 이전 날짜 또는 동일한 날짜인 항목만 가져옵니다. 특정 날짜를 입력할 때는 로컬 컴퓨터에 구성된 국가별 옵션 설정에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어, 간단한 날짜 형식 mm/dd/yyyy를 사용하도록 컴퓨터가 구성된 경우 2006년 3월 1일을 지정하려면 03/01/2006을 입력합니다.

ExcludeFolders

선택

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

ExcludeFolders 매개 변수는 가져올 때 제외할 폴더의 목록을 지정합니다.

GlobalCatalog

선택

Microsoft.Exchange.Data.Fqdn

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

Identity

선택

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Identity 매개 변수는 데이터를 가져올 대상 사서함 개체를 지정합니다. 다음 값 중에서 하나를 사용할 수 있습니다.

  • ADObjectID

  • DN(고유 이름)

  • 레거시 Exchange DN

  • GUID

  • 도메인\계정 이름

  • UPN(User Principal Name)

  • 전자 메일 주소

  • Alias

Get-Mailbox 명령 개체가 파이프된 경우 이 매개 변수가 필요하지 않습니다.

IncludeFolders

선택

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

IncludeFolders 매개 변수는 가져오는 동안 포함할 폴더의 목록을 지정합니다.

Locale

선택

System.Globalization.CultureInfo

Locale 매개 변수는 가져올 메시지의 로캘을 지정합니다. 명령은 사용자가 지정하는 로캘이 있는 메시지만 가져옵니다.

MaxThreads

선택

System.Int32

MaxThreads 매개 변수는 사용할 최대 스레드 수를 지정합니다. 기본값은 4입니다.

RecipientKeywords

선택

System.String[]

RecipientKeywords 매개 변수는 가져오기에 포함할 콘텐츠의 키워드를 지정합니다. 명령이 받는 사람 목록에서 지정하는 키워드를 찾으면 이 명령은 이러한 메시지를 가져옵니다.

ReportFile

선택

Microsoft.Exchange.Data.LocalLongFullPath

ReportFile 매개 변수는 XML 보고서 로그의 경로와 파일 이름을 지정합니다.

SenderKeywords

선택

System.String[]

SenderKeywords 매개 변수는 가져오기에 포함할 콘텐츠의 키워드를 지정합니다. 명령이 보낸 사람에서 지정하는 키워드를 찾으면 이 명령은 이러한 메시지를 가져옵니다.

StartDate

선택

System.DateTime

StartDate 매개 변수는 대상 사서함으로 가져올 내용을 필터링할 때 기준이 되는 시작 날짜를 지정합니다. .pst 파일에서 지정한 시작 날짜 이후 날짜인 항목만 가져옵니다. 특정 날짜를 입력할 때는 로컬 컴퓨터에 구성된 국가별 옵션 설정에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어, 간단한 날짜 형식 mm/dd/yyyy를 사용하도록 컴퓨터가 구성된 경우 2006년 3월 1일을 지정하려면 03/01/2006을 입력합니다.

SubjectKeywords

선택

System.String[]

SubjectKeywords 매개 변수는 .pst 파일의 항목 제목을 필터링하는 데 사용할 키워드 필터를 지정합니다.

ValidateOnly

선택

System.Management.Automation.SwitchParameter

ValidateOnly 매개 변수는 데이터를 가져오지 않고 가져오기를 확인하는 옵션을 제공합니다. ValidateOnly 매개 변수는 명령에 필요한 선행 조건을 확인합니다.

참고

이 매개 변수와 함께 Import-Mailbox 명령을 실행하면 명령은 메시지에 어떠한 필터도 적용하지 않습니다. 원본 및 대상 사서함이 있을 경우에만 검사합니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다.

입력 형식

반환 형식

오류

오류 설명

 

예제

첫 번째 예에서는 C:\PSTFiles\john.pst 파일의 데이터를 기존의 john@contoso.com이라는 연결된 사서함으로 가져오는 방법을 보여줍니다.

두 번째 예에서는 C:\PSTFiles에 있는 모든 .pst 파일의 데이터를 기존 사서함으로 가져오는 방법을 보여줍니다. .pst 파일은 <별칭>.pst라는 이름을 지정해야 하며 여기서, 별칭은 데이터를 가져올 사서함의 별칭입니다. 각 .pst 파일에 대해 01/01/2007 이후 받은 메시지가 사서함으로 가져옵니다.

세 번째 예에서는 .pst 파일의 데이터를 마케팅 조직 구성 단위에 있는 사용자의 사서함으로 가져오는 방법을 보여줍니다. .pst 파일은 <별칭>.pst라는 이름을 지정해야 하며 여기서, 별칭은 데이터를 가져올 사서함의 별칭입니다. 마케팅 조직 구성 단위의 사용자에 해당하는 별칭을 가진 .pst 파일만 가져옵니다. 마케팅 조직 구성 단위의 사용자에 대해 .pst 파일이 C:\PSTFiles에 없는 경우 오류를 받게 됩니다.

Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2007
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles