User guide: ExchM v0.1
Version
1.0
Daniel Buonocore
Thursday, March 3, 2011 revision 1
1.0 | Version ExchM v0.1
ExchM v0.1 2 | P a g e
1. Introduction to ExchM ...................................................................................................................... 3
2. Requirements to use ExchM ............................................................................................................. 3
3. Configuring Domain credentials ....................................................................................................... 4
4. Adding PST files to use with ExchM .................................................................................................. 4
File menu: Import ‐> From Folder .................................................................................................. 4
Drag and Drop Files/Folders .......................................................................................................... 5
File menu: Import ‐> From File ...................................................................................................... 6
5. Assign Mailbox to… ........................................................................................................................... 6
Assign to User ................................................................................................................................ 6
Find User ........................................................................................................................................ 7
Show Users ..................................................................................................................................... 7
6. Check PST File .................................................................................................................................... 8
7. New Import Request Queue ............................................................................................................. 8
"Mailbox Import Export" Permissions ........................................................................................... 8
Folder Permissions ......................................................................................................................... 8
Change the Mailbox language to match the PST language before import .................................... 9
New Import Request Queue Settings ............................................................................................ 9
BadItemLimit .............................................................................................................................. 9
AcceptLargeDataLoss ............................................................................................................... 10
ConflictResolutionOption .......................................................................................................... 10
Run the New Import Request Queue ........................................................................................... 10
Suspend .................................................................................................................................... 10
IsArchive ................................................................................................................................... 10
8. Import Queue .................................................................................................................................. 11
Settings ......................................................................................................................................... 11
1.0 | Version ExchM v0.1
ExchM v0.1 3 | P a g e
1. Introduction to ExchM ExchM allows you to import PST files into an Exchange 2010 mailbox. ExchM uses the Exchange 2010 Powershell commands to start the import request. In combination with Outlook it can determine the language in which the PST file has been saved. Then the mailbox can be set to the same language before the PST file is imported. When the import request is started it is possible to view the Import Queue to follow the import progress and if necessary view the import log file.
Download: ExchM
2. Requirements to use ExchM To use ExchM, the following requirements have to be met: Windows XP/7/2003/2008/2008 R2 (32/64) Microsoft Outlook 2007/2010 (32/64) The windows machine has to be a domain member Microsoft .NET Framework 2.0 Powershell 2.0 You need to grant read/write permission for the group Exchange Trusted Subsystem to the
network share where you'll export or import mailboxes. If you don't grant this permission, you'll receive an error message stating that Exchange is unable to establish a connection to the target mailbox
To import or export mailbox data, you need to add the Mailbox Import Export management role to a role group
1.0 | Version ExchM v0.1
ExchM v0.1 4 | P a g e
3. Configuring Domain credentials 1. Click the settings tab
2. Type in the Username, Password and the HUB Transport Servername. The FQDN will be
added automatically
4. Adding PST files to use with ExchM There are 3 ways to add PST files to ExchM. You have to use the UNC path only, if you do not, then the import will fail with an error.
File menu: Import ‐> From Folder
1.0 | Version ExchM v0.1
ExchM v0.1 5 | P a g e
1. Click File‐>Import‐>From Folder
2. Select an PST file and click Open
Drag and Drop Files/Folders
Select files or a folder, then drag them over the PST Import list view and drop them. Only files with the extension PST will be added. If a folder is dropped the PST files in the folder and subfolders are added.
1.0 | Version ExchM v0.1
ExchM v0.1 6 | P a g e
File menu: Import ‐> From File
The From File import option provides a way for you to import data from a comma‐separated value file (CSV) and then display that data in the PST Import list view. The following example shows you how the CSV file should look like.
5. Assign Mailbox to… To assign the PST file to a Mailbox you need to select a user so that the PST file can be imported to the correct Mailbox. When you assign the user to a mailbox ExchM will query the Active Directory to find the user. If the user is found, it will also check if the user is mail enabled. Every time a new user is assigned to a mailbox ExchM will query the Active Directory. When the PST files are added, the filename will be used to assign the PST file to the correct mailbox, if this is not correct you can assign a different user to import the PST file in to the correct mailbox. You have 3 options to assign the correct mailbox: Assign to User, Find User and Show user. Let’s start with …
Assign to User
If you want to assign a user quickly, type the username in the textbox and click OK.
1.0 | Version ExchM v0.1
ExchM v0.1 7 | P a g e
Find User
Select Find User from the context menu and a new window is opened. Then you can select a user and click OK or double‐click it to assign to user to the PST file.
Show Users
The last option is Show Users. Select this option from the context menu. At the right side of the screen, a new panel will open. Click Refresh to load all users.
Double‐click the selected user to assign the user to the PST file.
1.0 | Version ExchM v0.1
ExchM v0.1 8 | P a g e
6. Check PST File ExchM has an option to identify the PST file language. When this option is checked, ExchM will start Outlook. When Outlook is running, it will open the PST files listed in ExchM in Outlook and scan all folders to identify witch language is used. When the language is found ExchM will remove the PST file from Outlook. If you want to use this option go to the settings menu check the option Inspect PST Folders to determine the language.
After assigning the users to the PST files you are ready to run Check PST File. If you have checked the option: Inspect PST folders to determine the language, ExchM will identify the PST file language. Then a query will run to find the user and mailbox in the Active Directory. If the user and mailbox are found and there were no errors while scanning the PST file the process is ready. Now you can start the Import Request.
To run Check PST File, select a file, open the context menu and click Check PST File. When the process is ready you can check the Eventlog for errors.
7. New Import Request Queue
"Mailbox Import Export" Permissions
You need to be assigned permissions before you can run the New Import Request. You can assign the permissions by running the cmdlet or you can use ExchM. EXAMPLE 1 This example assigns the Mailbox Import Export role to the user Administrator New-ManagementRoleAssignment -Role "Mailbox Import Export" -User administrator ExchM gives you the possibility to run this cmdlet from the settings tab. Go to the Settings tab en click Assign "Mailbox Import Export" role
Folder Permissions
You need to grant read/write permission to the group Exchange Trusted Subsystem to the network share where you will import the selected mailboxes. If you don't grant this permission, you'll receive an error message stating that Exchange is unable to establish a connection to the target mailbox.
1.0 | Version ExchM v0.1
ExchM v0.1 9 | P a g e
Change the Mailbox language to match the PST language before import
When importing PST files into a Mailbox it’s important that the language matches. After Check PST File determines the PST file language, ExchM will set the mailbox language identical to the PST file. To enable this option you have to check Change the Mailbox language to match the PST language before import on the settings tab. ExchM will run the cmdlet to change the mailbox language before import: EXAMPLE 1 This example sets User01's mailbox to have the language set as Dutch and resets the default folder names to Dutch 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 preferences in the Exchange Control Panel (ECP). EXAMPLE 2 This example sets all mailboxes to have the language set as Dutch and resets the default folder names to Dutch Get-Mailbox | set-mailboxregionalconfiguration -Language nl-NL -DateFormat "d-M-yyyy" -LocalizeDefaultFolderName:$true
New Import Request Queue Settings
ExchM uses the New‐MailboxImportRequest cmdlet to begin the process of importing a PST file to a mailbox or archive. In ExchM you can configure 3 parameters.
BadItemLimit
The BadItemLimit parameter specifies the number of bad items to skip if the request encounters corruption in the mailbox. Use 0 to not skip bad items. The valid input range for 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 request fails. If you set the BadItemLimit parameter to more than 50, the command fails, and you receive a warning stating: "Please confirm your intention to accept a large amount of data loss by specifying AcceptLargeDataLoss." If you receive this warning, you need to run the command again, this time using the AcceptLargeDataLoss parameter. No further warnings appear, and any corrupted items aren't available after the move to the destination mailbox is complete.
1.0 | Version ExchM v0.1
ExchM v0.1 10 | P a g e
AcceptLargeDataLossThe AcceptLargeDataLoss parameter specifies that a large amount of data loss is acceptable if the BadItemLimit is set to 51 or higher. Items are considered corrupted if the item can't be read from the source database or can't be written to the target database. Corrupted items won't be available in the destination mailbox or PST file.
ConflictResolutionOption
The ConflictResolutionOption parameter specifies the action for the Microsoft Exchange Mailbox Replication service (MRS) to take if there are multiple matching messages in the target. This parameter takes the following values:
KeepSourceItem KeepLatestItem KeepAll
The default value is KeepSourceItem.
Run the New Import Request Queue
Now you can run the New Import Request Queue.
Suspend
The Suspend switch specifies whether to suspend the request. If you use this switch, the request is queued, but the request won't reach the status of InProgress until you resume the request. You don't have to specify a value with this switch.
IsArchive
The IsArchive switch specifies that you're importing the PST file into the user's archive.
1.0 | Version ExchM v0.1
ExchM v0.1 11 | P a g e
EXAMPLE 1 This example imports the Administrator.pst file into the administrator mailbox New-MailboxImportRequest -Mailbox 'administrator' -FilePath '\\localhost\Exp-PST\administrator.pst' -BadItemLimit 1000 -AcceptLargeDataLoss -ConflictResolutionOption KeepLatestItem
EXAMPLE 2 This example imports the Administrator.pst file into the administrators mailbox and sets it suspended New-MailboxImportRequest -Mailbox 'administrator' -FilePath '\\localhost\Exp-PST\administrator.pst' -BadItemLimit 1000 -AcceptLargeDataLoss -ConflictResolutionOption KeepLatestItem - Suspend
8. Import Queue
Settings
Show Import Queue status icons in PST Import When this option is checked ExchM will change the status icon when you Refresh the Import Queue.
Change background color When this option is checked ExchM will change the background color when you Refresh the Import Queue.
1.0 | Version ExchM v0.1
ExchM v0.1 12 | P a g e
Click Refresh from the context menu to view the import items.
Refresh cmdlet EXAMPLE 1 This example refreshes the Import Queue Get-MailboxImportRequest | Get-MailboxImportRequestStatistics | fl TargetAlias,Status,PercentComplete,BytesTransferred,BytesTransferredPerMinute,ItemsTransferred,EstimatedTransferItemCount,BadItemsEncountered,RequestGuid
1.0 | Version ExchM v0.1
ExchM v0.1 13 | P a g e
View Log cmdlet EXAMPLE 1 This example shows import Report and Message, where –Identity is RequestGuid Get-MailboxImportRequestStatistics -Identity '0445dc83-c513-4e51-be76-0f973a2c270e' -IncludeReport | fl Message,Report
1.0 | Version ExchM v0.1
ExchM v0.1 14 | P a g e
Properties cmdlet EXAMPLE 1 This example shows import Properties, where –Identity is RequestGuid Get-MailboxImportRequestStatistics -Identity '0445dc83-c513-4e51-be76-0f973a2c270e'
Suspend cmdlet EXAMPLE 1 This example Suspends an selected list item, where –Identity is RequestGuid Suspend-MailboxImportRequest -Identity '0445dc83-c513-4e51-be76-0f973a2c270e' -Confirm:$false
1.0 | Version ExchM v0.1
ExchM v0.1 15 | P a g e
Resume cmdlet EXAMPLE 1 This example Resumes an selected list item, where –Identity is RequestGuid Resume-MailboxImportRequest -Identity '0445dc83-c513-4e51-be76-0f973a2c270e' -Confirm:$false
Remove cmdlet EXAMPLE 1 This example Removes an selected list item, where –Identity is RequestGuid Remove-MailboxImportRequest -Identity '82497f77-9428-408b-b406-bd633d69b5ef' -Confirm:$false Remove “‐Status Completed” cmdlet EXAMPLE 1 This example Removes all items with the ‐Status Completed Get-MailboxImportRequest -Status Completed | Remove-MailboxImportRequest -Confirm:$false Remove “‐Status Failed” cmdlet EXAMPLE 1 This example Removes all items with the ‐Status Failed Get-MailboxImportRequest -Status Failed | Remove-MailboxImportRequest -Confirm:$false Remove All cmdlet EXAMPLE 1 This example Removes all items from the queue Get-MailboxImportRequest | Remove-MailboxImportRequest -Confirm:$false
Copy this context menu item will copy the selected list item information to the clipboard.