Version

1.0

Userguide:ExchMv0.1

DanielBuonocore
Thursday,March3,2011revision1

1.0 | Version
ExchM v0.1

1.

IntroductiontoExchM......................................................................................................................3

2.

RequirementstouseExchM.............................................................................................................3

3.

ConfiguringDomaincredentials.......................................................................................................4

4.

AddingPSTfilestousewithExchM..................................................................................................4

Filemenu:Import>FromFolder..................................................................................................4

DragandDropFiles/Folders..........................................................................................................5

Filemenu:Import>FromFile......................................................................................................6

5.

AssignMailboxto...........................................................................................................................6

AssigntoUser................................................................................................................................6

FindUser........................................................................................................................................7

ShowUsers.....................................................................................................................................7

6.

CheckPSTFile....................................................................................................................................8

7.

NewImportRequestQueue.............................................................................................................8

"MailboxImportExport"Permissions...........................................................................................8

FolderPermissions.........................................................................................................................8

ChangetheMailboxlanguagetomatchthePSTlanguagebeforeimport....................................9

NewImportRequestQueueSettings............................................................................................9

BadItemLimit..............................................................................................................................9

AcceptLargeDataLoss...............................................................................................................10

ConflictResolutionOption..........................................................................................................10

8.

RuntheNewImportRequestQueue...........................................................................................10

Suspend....................................................................................................................................10

IsArchive...................................................................................................................................10

ImportQueue..................................................................................................................................11

Settings.........................................................................................................................................11

ExchMv0.1

2|P a g e

1.0 | Version
ExchM v0.1

1. IntroductiontoExchM
ExchMallowsyoutoimportPSTfilesintoanExchange2010mailbox.ExchMusestheExchange2010
Powershellcommandstostarttheimportrequest.IncombinationwithOutlookitcandeterminethe
language in which the PST file has been saved. Then the mailbox can be set to the same language
beforethePSTfileisimported.WhentheimportrequestisstarteditispossibletoviewtheImport
Queuetofollowtheimportprogressandifnecessaryviewtheimportlogfile.

Download:ExchM

2. RequirementstouseExchM
TouseExchM,thefollowingrequirementshavetobemet:
WindowsXP/7/2003/2008/2008R2(32/64)
MicrosoftOutlook2007/2010(32/64)
Thewindowsmachinehastobeadomainmember
Microsoft.NETFramework2.0
Powershell2.0
Youneedtograntread/writepermissionforthegroupExchangeTrustedSubsystemtothe
networksharewhereyou'llexportorimportmailboxes.Ifyoudon'tgrantthispermission,
you'llreceiveanerrormessagestatingthatExchangeisunabletoestablishaconnectionto
thetargetmailbox
Toimportorexportmailboxdata,youneedtoaddtheMailboxImportExportmanagement
roletoarolegroup

ExchMv0.1

3|P a g e

1.0 | Version
ExchM v0.1

3. ConfiguringDomaincredentials
1. Clickthesettingstab

2. TypeintheUsername,PasswordandtheHUBTransportServername.TheFQDNwillbe
addedautomatically

4. AddingPSTfilestousewithExchM
Thereare3waystoaddPSTfilestoExchM.YouhavetousetheUNCpathonly,ifyoudonot,then
theimportwillfailwithanerror.

Filemenu:Import>FromFolder

ExchMv0.1

4|P a g e

1.0 | Version
ExchM v0.1

1. ClickFile>Import>FromFolder

2. SelectanPSTfileandclickOpen

DragandDropFiles/Folders
Selectfilesorafolder,thendragthemoverthePSTImportlistviewanddropthem.Onlyfileswith
theextensionPSTwillbeadded.IfafolderisdroppedthePSTfilesinthefolderandsubfoldersare
added.

ExchMv0.1

5|P a g e

1.0 | Version
ExchM v0.1

Filemenu:Import>FromFile
TheFromFileimportoptionprovidesawayforyoutoimportdatafromacommaseparatedvalue
file(CSV)andthendisplaythatdatainthePSTImportlistview.Thefollowingexampleshowsyou
howtheCSVfileshouldlooklike.

5. AssignMailboxto
ToassignthePSTfiletoaMailboxyouneedtoselectausersothatthePSTfilecanbeimportedto
thecorrectMailbox.WhenyouassigntheusertoamailboxExchMwillquerytheActiveDirectoryto
findtheuser.Iftheuserisfound,itwillalsocheckiftheuserismailenabled.Everytimeanewuseris
assignedtoamailboxExchMwillquerytheActiveDirectory.

WhenthePSTfilesareadded,thefilenamewillbeusedtoassignthePSTfiletothecorrectmailbox,
ifthisisnotcorrectyoucanassignadifferentusertoimportthePSTfileintothecorrectmailbox.
Youhave3optionstoassignthecorrectmailbox:AssigntoUser,FindUserandShowuser.Letsstart
with

AssigntoUser
Ifyouwanttoassignauserquickly,typetheusernameinthetextboxandclickOK.

ExchMv0.1

6|P a g e

1.0 | Version
ExchM v0.1

FindUser
SelectFindUserfromthecontextmenuandanewwindowisopened.Thenyoucanselectauserand
clickOKordoubleclickittoassigntousertothePSTfile.

ShowUsers
The last option is Show Users. Select this option from the context menu. At the right side of the
screen,anewpanelwillopen.ClickRefreshtoloadallusers.

DoubleclicktheselectedusertoassigntheusertothePSTfile.

ExchMv0.1

7|P a g e

1.0 | Version
ExchM v0.1

6. CheckPSTFile
ExchMhasanoptiontoidentifythePSTfilelanguage.Whenthisoptionischecked,ExchMwillstart
Outlook.WhenOutlookisrunning,itwillopenthePSTfileslistedinExchMinOutlookandscanall
folderstoidentifywitchlanguageisused.WhenthelanguageisfoundExchMwillremovethePSTfile
fromOutlook.IfyouwanttousethisoptiongotothesettingsmenuchecktheoptionInspectPST
Folderstodeterminethelanguage.

AfterassigningtheuserstothePSTfilesyouarereadytorunCheckPSTFile.Ifyouhavecheckedthe
option: Inspect PST folders to determine the language, ExchM will identify the PST file language.
ThenaquerywillruntofindtheuserandmailboxintheActiveDirectory.Iftheuserandmailboxare
foundandtherewerenoerrorswhilescanningthePSTfiletheprocessisready.Nowyoucanstart
theImportRequest.

To run Check PST File, select a file, open the context menu and click Check PST File. When the
processisreadyyoucanchecktheEventlogforerrors.

7. NewImportRequestQueue
"MailboxImportExport"Permissions
YouneedtobeassignedpermissionsbeforeyoucanruntheNewImportRequest.Youcanassignthe
permissionsbyrunningthecmdletoryoucanuseExchM.
EXAMPLE1
ThisexampleassignstheMailboxImportExportroletotheuserAdministrator
New-ManagementRoleAssignment -Role "Mailbox Import Export" -User administrator

ExchM gives you the possibility to run this cmdletfrom the settings tab. Go to the Settings tab en
clickAssign"MailboxImportExport"role

FolderPermissions
Youneedtograntread/writepermissiontothegroupExchangeTrustedSubsystemtothenetwork
sharewhereyouwillimporttheselectedmailboxes.Ifyoudon'tgrantthispermission,you'llreceive
anerrormessagestatingthatExchangeisunabletoestablishaconnectiontothetargetmailbox.

ExchMv0.1

8|P a g e

1.0 | Version
ExchM v0.1

ChangetheMailboxlanguagetomatchthePSTlanguagebeforeimport
WhenimportingPSTfilesintoaMailboxitsimportantthatthelanguagematches.AfterCheckPST
FiledeterminesthePSTfilelanguage,ExchMwillsetthemailboxlanguageidenticaltothePSTfile.To
enable this option you have to check Change the Mailbox language to match the PST language
beforeimportonthesettingstab.ExchMwillrunthecmdlettochangethemailboxlanguagebefore
import:

EXAMPLE1
ThisexamplesetsUser01'smailboxtohavethelanguagesetasDutchandresetsthedefaultfoldernamestoDutch
Set-MailboxRegionalConfiguration identity user01 -Language nl-NL -DateFormat
"d-M-yyyy" -LocalizeDefaultFolderName:$true

When the import is ready you need to change the language manually back to the users preferred
language.

When ready the mailbox language can be changed to the users preferred language. By running a
cmdlet you can change it for all users. The user has also the possibility to change the language
preferencesintheExchangeControlPanel(ECP).

EXAMPLE2
ThisexamplesetsallmailboxestohavethelanguagesetasDutchandresetsthedefaultfoldernamestoDutch
Get-Mailbox | set-mailboxregionalconfiguration -Language nl-NL -DateFormat "d-Myyyy" -LocalizeDefaultFolderName:$true

NewImportRequestQueueSettings
ExchMusestheNewMailboxImportRequestcmdlettobegintheprocessofimportingaPSTfiletoa
mailboxorarchive.InExchMyoucanconfigure3parameters.
BadItemLimit
The BadItemLimit parameter specifies the number of bad items to skip if the request
encounterscorruptioninthemailbox.Use0tonotskipbaditems.Thevalidinputrangefor
this parameter is from 0 through 2147483647. The default value is 0. We recommend that
you keep the default value 100 and only change the BadItemLimit parameter value if the
requestfails.

IfyousettheBadItemLimitparametertomorethan50,thecommandfails,andyoureceivea
warning stating: "Please confirm your intention to accept a large amount of data loss by
specifyingAcceptLargeDataLoss."Ifyoureceivethiswarning,youneedtorunthecommand
again,thistimeusingtheAcceptLargeDataLossparameter.Nofurtherwarningsappear,and
anycorrupteditemsaren'tavailableafterthemovetothedestinationmailboxiscomplete.

ExchMv0.1

9|P a g e

1.0 | Version
ExchM v0.1

AcceptLargeDataLoss
TheAcceptLargeDataLossparameterspecifiesthatalargeamountofdatalossisacceptableif
theBadItemLimitissetto51orhigher.Itemsareconsideredcorruptediftheitemcan'tbe
read from the source database or can't be written to the target database. Corrupted items
won'tbeavailableinthedestinationmailboxorPSTfile.

ConflictResolutionOption
The ConflictResolutionOption parameter specifies the action for the MicrosoftExchange
Mailbox Replication service(MRS) to take if there are multiple matching messages in the
target.Thisparametertakesthefollowingvalues:

KeepSourceItem
KeepLatestItem
KeepAll

The default value is KeepSourceItem.

RuntheNewImportRequestQueue
NowyoucanruntheNewImportRequestQueue.

Suspend
TheSuspendswitchspecifieswhethertosuspendtherequest.Ifyouusethisswitch,therequestis
queued,buttherequestwon'treachthestatusofInProgressuntilyouresumetherequest.Youdon't
havetospecifyavaluewiththisswitch.
IsArchive
TheIsArchiveswitchspecifiesthatyou'reimportingthePSTfileintotheuser'sarchive.

ExchMv0.1

10|P a g e

1.0 | Version
ExchM v0.1

EXAMPLE1
ThisexampleimportstheAdministrator.pstfileintotheadministratormailbox
New-MailboxImportRequest -Mailbox 'administrator' -FilePath '\\localhost\ExpPST\administrator.pst' -BadItemLimit 1000 -AcceptLargeDataLoss ConflictResolutionOption KeepLatestItem

EXAMPLE2
ThisexampleimportstheAdministrator.pstfileintotheadministratorsmailboxandsetsitsuspended
New-MailboxImportRequest -Mailbox 'administrator' -FilePath '\\localhost\ExpPST\administrator.pst' -BadItemLimit 1000 -AcceptLargeDataLoss ConflictResolutionOption KeepLatestItem -Suspend

8. ImportQueue
Settings
ShowImportQueuestatusiconsinPSTImportWhenthisoptionischeckedExchMwillchangethe
statusiconwhenyouRefreshtheImportQueue.

ChangebackgroundcolorWhenthisoptionischeckedExchMwillchangethebackgroundcolorwhen
youRefreshtheImportQueue.

ExchMv0.1

11|P a g e

1.0 | Version
ExchM v0.1

ClickRefreshfromthecontextmenutoviewtheimportitems.

Refreshcmdlet

EXAMPLE1

ThisexamplerefreshestheImportQueue
Get-MailboxImportRequest | Get-MailboxImportRequestStatistics | fl
TargetAlias,Status,PercentComplete,BytesTransferred,BytesTransferredPerMinute,Item
sTransferred,EstimatedTransferItemCount,BadItemsEncountered,RequestGuid

ExchMv0.1

12|P a g e

1.0 | Version
ExchM v0.1

ViewLogcmdlet

EXAMPLE1
ThisexampleshowsimportReportandMessage,whereIdentityisRequestGuid
Get-MailboxImportRequestStatistics -Identity '0445dc83-c513-4e51-be760f973a2c270e' -IncludeReport | fl Message,Report

ExchMv0.1

13|P a g e

1.0 | Version
ExchM v0.1

Propertiescmdlet

EXAMPLE1
ThisexampleshowsimportProperties,whereIdentityisRequestGuid
Get-MailboxImportRequestStatistics -Identity '0445dc83-c513-4e51-be760f973a2c270e'

Suspendcmdlet

EXAMPLE1
ThisexampleSuspendsanselectedlistitem,whereIdentityisRequestGuid
Suspend-MailboxImportRequest -Identity '0445dc83-c513-4e51-be76-0f973a2c270e' Confirm:$false

ExchMv0.1

14|P a g e

1.0 | Version
ExchM v0.1

Resumecmdlet

EXAMPLE1
ThisexampleResumesanselectedlistitem,whereIdentityisRequestGuid
Resume-MailboxImportRequest -Identity '0445dc83-c513-4e51-be76-0f973a2c270e' Confirm:$false

Removecmdlet

EXAMPLE1
ThisexampleRemovesanselectedlistitem,whereIdentityisRequestGuid
Remove-MailboxImportRequest -Identity '82497f77-9428-408b-b406-bd633d69b5ef' Confirm:$false

RemoveStatusCompletedcmdlet

EXAMPLE1
ThisexampleRemovesallitemswiththeStatusCompleted
Get-MailboxImportRequest -Status Completed | Remove-MailboxImportRequest Confirm:$false

RemoveStatusFailedcmdlet

EXAMPLE1
ThisexampleRemovesallitemswiththeStatusFailed
Get-MailboxImportRequest -Status Failed | Remove-MailboxImportRequest Confirm:$false

RemoveAllcmdlet

EXAMPLE1
ThisexampleRemovesallitemsfromthequeue
Get-MailboxImportRequest | Remove-MailboxImportRequest -Confirm:$false

Copythiscontextmenuitemwillcopytheselectedlistiteminformationtotheclipboard.

ExchMv0.1

15|P a g e