Ask the Community
Groups
How To: Importing PSTs Files in Office 365 - Connect IT Community | Kaseya
<main> <article class="userContent"> <div> <h1 data-id="import-pst-files-to-office-365">Import PST Files to Office 365</h1> <p> </p> <p><strong>PLEASE NOTE: There is a change in this program. By default if imports into the Root of Mailbox. If that is not what you desire please change the settings accordingly.</strong></p> <p> </p> <p>To Import PST Files into Office 365 choose the Import PST Files option on the main screen and click Next.</p> </div> <p> <img src="/attachments/token/8hYw6HeZrYkBPEUDF504Ak3iv/?name=ImportPSTsOptionSelect.jpg" alt="ImportPSTsOptionSelect.jpg" class="embedImage-img importedEmbed-img"></img></p> <p>On the next screen you will be prompted for your Administration Credentials for Office 365. <strong>This account must have a mailbox.</strong></p> <p> <img src="/attachments/token/A3pocEwRHY8it7yTCNj0dQLaj/?name=ImportPSTsOptions.jpg" alt="ImportPSTsOptions.jpg" class="embedImage-img importedEmbed-img"></img></p> <ul><li>If the user Classic Interface is selected the PowerShell endpoint is Outlook.Office365.com. If deselected the the end point is ps.outlook.com.</li> <li>If the Show Mailbox Size checkbox is selected, it can take much longer to load the list of mailboxes.</li> <li>Filter Get-Mailbox request is used primary for selecting the Select DiscoveryMailbox only. In other uses it can be used as a filter. For example, PrimarySMTPAddress -eq '<a rel="nofollow" href="mailto:user@domain.com">user@domain.com</a>'.</li> <li>In larger organizations you can use MAPI to Get Mailboxes from the GAL instead of Remote PowerShell. Checking this option results in a small performance improvement.</li> <li>If you have a license key for over 1000 users, you can skip Getting All Mailboxes via Remote PowerShell. You will then have to search for the mailboxes or use a CSV file on the next screen.</li> </ul><h2 data-id="basic-migration">Basic Migration</h2> <p>The example below will describe a basic migration and then we'll get into more advanced migrations. </p> <p> <img src="/attachments/token/hK9dKlgHKWrRU63xYxsBvrkFv/?name=ImportPSTsMainScreen.jpg" alt="ImportPSTsMainScreen.jpg" class="embedImage-img importedEmbed-img"></img></p> <p>So Step 1 is to select the Import Source. There you will presented with a Select PST File, which will allow you to select a PST.</p> <p><img src="/attachments/token/aTkX6YLSoWD2JNcYbM4p1lw6X/?name=ImportPSTsSouceDetails.jpg" alt="ImportPSTsSouceDetails.jpg" class="embedImage-img importedEmbed-img"></img></p> <p>Next you'll want to choose the Destination from the Select Mailbox screen.</p> <p><img src="/attachments/token/GCDl03wCIHtAy9YF76PbCvpg3/?name=ImportPSTsDestination.jpg" alt="ImportPSTsDestination.jpg" class="embedImage-img importedEmbed-img"></img></p> <p>Next you'll want choose where it goes. The Mailbox is the root of mailbox and the root is the top level of this mailbox. So this will place all items in the same location as they were the source mailbox. If you were to choose Archive, they would be placed in the same place in place in the Archive. If you chose PST name this would create a PST Name (based on the name of the PST file that exists in the archive) in the folder specified.</p> <p><img src="/attachments/token/yLKJ3nnrZGc9Psx1zaUJkRPnL/?name=ImportPSTsDestination2.jpg" alt="ImportPSTsDestination2.jpg" class="embedImage-img importedEmbed-img"></img></p> <p>Next click the Add to Import Queue. You can repeat this process for users. Then click the Start Import button to start the import.</p> <h2 data-id="advanced-migrations">Advanced Migrations</h2> <h3 data-id="csv-import">CSV Import</h3> <p>If you want to import a list of PST files, the format for the .csv is simply:</p> <p>When using the CSV option your CSV file needs a valid header row</p> <p>An example of a csv with a valid header row should look like</p> <p>Mailbox,PstFileName,Destination,Usepstrootname,Useaddressrewrite</p> <p>user@domain.onmicrosoft.com,c:\temp\filetoImporttoMailbox.pst,Mailbox,TRUE,TRUE<br>user@domain.onmicrosoft.com,c:\temp\filetoImporttoArchive.pst,Archive,TRUE,TRUE</p> <p><strong>Valid header rows</strong></p> <p>Pstfilename : Path to the PST you are importing<br>SourceMailbox : Used when importing from On-Premise Exchange<br>Destination : Primary SMTP address of the Mailbox you are importing to<br>Usepstrootname : If true a subfolder will be created to import into otherwise false mailbox root will be used<br>Useaddressrewrite : if true Address rewriting will be used (enabled by default)<br>Dontimportdeleteditems : if true deleted Items will not be imported<br>excludefolders : contains folders to exclude for the export separated with a ; eg \Inbox;\SendItems;\Contacts<br>excludesubfolders : if true the subfolders of the exclude folder will be excluded as well<br>includefolders : contains folders to Include in the import separated with a ; eg \Inbox;\SendItems;\Contacts<br>includesubfolders : if true the subfolders of the include folder will be included as well</p> <h3 data-id="select-a-history-file">Select a History File </h3> <div> <p>The History files are good if something goes wrong with Exchange Migrator. You can simply click on the History file and restore the last good know configuration. This is often times good if the Exchange Migrator if the program expectantly terminates. </p> <h3 data-id="folder-filtering">Folder Filtering</h3> <p>Folder Filtering can either be Enabled or Disabled. If you choose the Select Folder Filter you'll be presented with the following the dialog box.</p> <p><img src="/attachments/token/0w7lH9LuNsGGs101xTsk60dH0/?name=ImportPSTsSelectFolder.jpg" alt="ImportPSTsSelectFolder.jpg" class="embedImage-img importedEmbed-img"></img></p> <p>Here you will enter all the folders you want to Include in export. Note at the bottom of the screen is a toggle for Include Subfolders of Selected Folders. On the Exclude screen you would simply enter the folder you wanted to Exclude from the export.</p> <h3 data-id="from-mailbox">From Mailbox</h3> <p>If you choose the From Mailbox you'll be presented with a Folder Filter button. </p> <p><img src="/attachments/token/qLo4V0GZpHPhCDSj7b76v4M41/?name=ImportPSTsFolderFilter.jpg" alt="ImportPSTsFolderFilter.jpg" class="embedImage-img importedEmbed-img"></img></p> </div> <p>Here you will enter all the folders you want to Include in export. Note at the bottom of the screen is a toggle for Include Subfolders of Selected Folders. On the Exclude screen you would simply enter the folder you wanted to Exclude from the export.</p> <p>In both of these examples, you should notice the PST File decreasing it's number of items.</p> <p><img src="/attachments/token/aFxDwOMBF2GOyCT7iuIPncIpY/?name=ImportPSTsDecrease.jpg" alt="ImportPSTsDecrease.jpg" class="embedImage-img importedEmbed-img"></img></p> <h3 data-id="skip-deleted-items">Skip Deleted Items</h3> <p>This setting excludes importing the Deleted Items folder in the PST and any sub folders in this folder.</p> <p>Import Options</p> <h3 data-id="upload-options">Upload Options</h3> <p><strong>Use MAPI and EWS for Upload</strong></p> <p>This setting will automatically be enabled or disabled depending on the version of Office 365 you are importing into. Checking this option will result in the best performance, but sometimes it is necessary to uncheck this option. By default, it uses both MAPI and EWS for throttling, but sometimes it's necessary to disable MAPI and just use EWS for uploads. </p> <p><strong>Use Direct Discover</strong></p> <p>This setting should be selected if the Autodiscover records aren’t setup for the domain you are trying to import PST files into. With this setting, the Exchange Migrator will attempt to directly connect to Office 365, bypassing the Autodiscover process.</p> <p><strong>Use EWS Impersonation</strong></p> <p>The default is to Use EWS Impersonation, meaning the migrator will impersonate the owner of the Mailbox when uploading items using EWS. Because of the throttling limitation imposed on Office365 this setting is recommended.</p> <p><strong>Use Throttle Switching</strong></p> <p>The default is to use throttle switching this controls how the application manages throttling to ensure best upload performance. </p> <h3 data-id="address-options"><strong>Address Options</strong></h3> <p><strong>Use Address Re-Re-Writing</strong></p> <p>Address rewriting will rewrite the Native Exchange email address format (for example EX: /o=First Organization/ou=first administrative group/cn=Recipients/cn=UserName’) which are only valid in the source Exchange organization to the SMTP address for the address entry if it can found within other message properties or resolved by looking at the Global Address List based on the Display Name of the recipient. Note because this is an automated processes exact address matching can never be 100% assured if GAL resolution is used and more than 1 contact has the same display name.</p> <p><strong>Import Auto Complete (Mailbox Only)</strong></p> <p>Re-writes contact information for mailboxes migrated to Office 365.</p> <h3 data-id="authentication">Authentication</h3> <p><strong>Auto Grant Full Mailbox Access </strong></p> <p>Should be enabled by default.</p> <p><strong>Skip Auto Remove Access</strong></p> <p>Should be disabled by default. If there is change where the Administrator account already has full control over the mailboxes this account step can be stopped.</p> <h3 data-id="error-processing">Error Processing</h3> <p><strong>Ignore Single Property Errors</strong></p> <p>By default this is enabled. This allows the Exchange Migrator to migrate any items that have a single property error.</p> <p><strong>Don't Save OverSize Messages</strong></p> <p>By default that setting is disabled. This allows the Exchange Migrator to not save any oversized messages.</p> <h3 data-id="duplicate-detection"><strong>Duplicate Detection</strong></h3> <p>The Custom Id (Best) option should be used if you are importing a static set of PST files using the Exchange Migrator. This will prevent duplicates if the exact same PST file is imported multiple times into the same mailbox. Note, exporting a mailbox more than 1 time to different PSTs will result in duplicates if this option is selected.</p> <p>The SourceKey option uses 3 different keys for duplicate detection. It first tries the PSTid, then it uses the SourceKey and then the SearchKey. The SourceKey and SearchKey should the be same on multiple copies of an the Item, so if this is used it shouldn’t import a message if it finds a match for either of these three keys. This should prevent duplicates in the instance where an aborted Outlook import has been performed and you want to use the Migrator.</p> <h3 data-id="notifications">Notifications</h3> <p>If checked you can specify an email address to send notifications to when operations complete or fail.</p> <p><strong>Thread Control</strong></p> <p>In most cases these shouldn’t be modified, but here is what these settings control.</p> <p>Max Threads – The number of simultaneous TCP connections to Exchange. The Exchange server will throttle any more than 10 simultaneous connections.</p> <p>Batch Size – The total number of message that will be sent in one batch. The actual batch size will depend on the size of the messages in the batch.</p> <h2 data-id="running-the-import">Running the Import</h2> <p>The import queue will look similar to that below.</p> <p><img src="/attachments/token/N0r7PBXzM65LmKpwvlk6aCiYX/?name=ImportPSTsImportQueue.jpg" alt="ImportPSTsImportQueue.jpg" class="embedImage-img importedEmbed-img"></img></p> <p>The log file link is in the upper left. That log will be the log that you send to Kaseya if you should need it.</p> <p>The Error Count is the total count of errors and the OverSize Count is the total number of oversized items.</p> <p>There are some stats about how fast the migration is going.</p> <p><img src="/attachments/token/1b4Pk5RHb4HxPkaSKfWvljRMo/?name=ImportPSTsImportLogs.jpg" alt="ImportPSTsImportLogs.jpg" class="embedImage-img importedEmbed-img"></img></p> <p> </p> <p><em>Updated: April 16, 2016</em></p> </article> </main>