M365 Destination Advanced Options

M365 Destination Advanced Options

This document will give an overview on all the Microsoft 365 Destination Advanced Options in CloudM Migrate.

SharePoint Online

1. SharePoint Migration API
2. SharePoint Storage
3. Storage Account Name
4. Storage Account Key
5. Retry Backoff
6. SharePoint Admin Url
7. Timeout
8. Preserve File Created and Modified Dates
9. Provision Sites
10. Hybrid Environment
11. SharePoint Storage
12. Retry Count
13. Retry Count
14. Truncate Folders and Files
15. Orphaned Items Folder
16. Provision Sites Timeout Check
17. Patch Permissions
18. Include Document Metadata

SharePoint Migration API

 Default Value: On

SharePoint Migration API is recommended for all migrations to SharePoint Online and OneDrive for Business. For more information see the article here.

Change Conditions: Disable to use CSOM API which is much slower, not recommended.

SharePoint Storage (dynamic)

Default: Office 365

Microsoft’s Import Migration API requires the use of an Azure container for temporary storage. When (Office 365) is selected files and manifests will be uploaded to containers provided by Microsoft. (Azure Hosted) allows you to provide your own storage/containers.

CloudM takes a snapshot of your destination using the Export Migration API which utilises storage containers. 'Storage Account Name' and 'Storage Account Key' are required for both (Office 365 and Azure Hosted).

Change Conditions: Only available if the option SharePoint Migration API is enabled.

Storage Account Name (dynamic)

Default: Blank

The name of the Azure storage account.

Change Conditions: Only available if the option SharePoint Migration API is enabled and SharePoint Storage is set to Azure Hosted.

Storage Account Key (dynamic)

 Default: Blank

The access key for the Azure storage account.

Change Conditions: Only available if the option SharePoint Migration API is enabled and SharePoint Storage is set to Azure Hosted.

Retry Backoff (seconds)

Default Value: 3

SharePoint Migration API Retry Backoff in seconds.

Change Conditions: Retry backoff time can be changed. Can cause performance issues, not recommended to change unless instructed by support.

SharePoint Admin Url

Default Value: None

The Url for the SharePoint admin center e.g. https://tenant-admin.sharepoint.com

Timeout

Default Value: 1800000

The timeout that will apply to communications with the SharePoint server.

Change Conditions: Timeout value (miliseconds) can be changed. Can cause performance issues, not recommended to be changed unless instructed by support.

Preserve File Created and Modified Dates

Default Value: On

Preserve the Original File Created and Modified Dates.

Change Conditions: If disabled the creation and modified dates will not be migrated.

Provision Sites

Default Value: On

Provision any Sites that do not exist.

Change Conditions: Disable to not provision Sharepoint sites.

Hybrid Environment

Default Value: On

Allows a custom 'SharePoint Admin Url' and 'SharePoint My Sites Url' to be entered for hybrid migration.

SharePoint Storage

Default Value: Office 365

Microsoft’s Import Migration API requires the use of an Azure container for temporary storage. When (Office 365) is selected files and manifests will be uploaded to containers provided by Microsoft. Azure Hosted allows you to provide your own storage/containers.

CloudM takes a snapshot of your destination using the Export Migration API which utilises storage containers. 'Storage Account Name' and 'Storage Account Key' are required for both (Office 365 and Azure Hosted).

Change Conditions: Choose the storage used, Office 365 free storage account or Azure Hosted.

Retry Count

Default Value: 20

SharePoint Migration API Retry Count

Change Conditions: Retry count can be changed. Can cause performance issues, not recommended unless instructed by support.

Retry Count

Default Value: 10

The number of times an operation will be attempted before failing.

Change Conditions: Retry count can be changed. Can cause performance issues, not recommended unless instructed by support.

Truncate Folders and Files

 Default Value: On

Attempt to truncate folders and files to fall within the 400 characters limit.

Change Conditions: If disabled, any folders and files with a path that exceeds Sharepoint's 400 character limit will fail to migrate.

Orphaned Items Folder

Default Value: None

Optionally place all failed truncated folders in the specified 'Orphan Items Folder'. Leave empty to fail migration if folders can not be truncated.

Change Conditions: This option much be set to a foldername in order to relocate files with paths longer then 400 characters. If not set, this will be an error item during the migration.

Provision Sites Timeout Check

Default Value: 180000

The maximum period of time used to check if a OneDrive site has been provisioned.

Change Conditions: Timeout value can be changed. Can cause performance issues, not recommended.

Patch Permissions

Default Value: None

Add/Update/Delete permissions for existing items. If disabled, only new permissions will be applied to existing items (see documentation).

Change Conditions: When enabled all permissions will be completely reapplied when performing delta migrations.

Include Document Metadata

Default Value: Off

Migrate standard document metadata, as well as Text, Boolean, Number and Datetime custom metadata.

Change Conditions: When enabled Migrate will export the following custom metadata; Single line text, Multi line text, Number, Yes/No and DateTime.

Email

1. Max Message Size
2. Use Chunked HTTP Web Requests
3. Strip Received Headers
4. Recoverable Items Destination

Max Message Size

Default Value: 52428800

The maximum message size (in bytes) that will be migrated.

Change Conditions: The maximum message size can be increased or decreased to allow or prevent emails above or below that size migrating.

Use Chunked HTTP Web Requests

Default Value: Off

When creating Mail items in Exchange, use HTTP web request chunking to increase performance. WARNING: some hosted Exchange environments do not support this method of communication.

Change Conditions: When enabled, chunked HTTP web requests will be used. Not recommended unless advised.

Strip Received Headers

 Default Value: Off

Strip any 'Received' headers and add a single 'Received' header with a value the same as the 'Date' header.

Change Conditions: Enable to replace received headers with the date.

Recoverable Items Destination

Default Value: Recoverable Items

When migrating items from the recoverable items folders, choose whether to place them in Recoverable Items or in the Mailbox.

Change Conditions: The default migrates recoverable items as is. Select 'Mailbox' to rehyrate recoverable items into the mailbox.

Calendar

Back to Top

1. Exchange 2007 Calendar Timezone
2. Exchange 2010/Office 365 Calendar Timezone

Exchange 2007 Calendar Timezone

{: .no_toc } Default Value: Gmt

The default timezone to use with appointments when migrating to Exchange 2007 when the timezone is not identified by other means.

Change Conditions: In the rare event that a calendar event does not have a timezone associated with it, the default zone selected here will be applied to ensure the item can be migrated.

Exchange 2010/Office 365 Calendar Timezone

{: .no_toc } Default Value: GMT Stadard Time

The default timezone to use with appointments when migrating to Exchange 2010/Office 365 when the timezone is not identified by other means.

Change Conditions: In the rare event that a calendar event does not have a timezone associated with it, the default zone selected here will be applied to ensure the item can be migrated.

Calendar Appointments

1. Appointment Body Type

Appointment Body Type

{: .no_toc } Default Value: Undefined

Identifies how the appointment body content is formatted. If left undefined it will be assigned based on appointment HtmlContent or TextContent properties. If set to 'Best' the body will be formatted based on the richest available content.

Microsoft Teams/Group

1. Timeout
2. Maximum Results Per Request
3. Provision Office 365 Group Timeout Check
4. Default Document Library Name
5. Teams Direct Migration
6. Migrate Team Channel Tabs
7. Retry Count
8. Create Office 365 Group
9. Test Office 365 Group Email
10. Chat Message Library Name
11. Finalize Teams Direct Migration
12. Rehydrate Teams Private Chat

Timeout

Default Value: 1800000

The timeout for operations with the server.

Change Conditions: Timeout value can be changed. Can cause performance issues, not recommended unless instructed by support.

Maximum Results Per Request

Default Value: 999

The maximum number of results to return for individual queries.

Change Conditions: Value can be changed. Can cause performance issues, not recommended unless instructed by support.

Provision Office 365 Group Timeout Check

Default Value: 600000

The maximum period of time used to check if an Office 365 Group has been created.

Change Conditions: Timeout value can be changed. Can cause performance issues, not recommended unless instructed by support.

Default Document Library Name

Default Value: Documents

When migrating Microsoft Teams and Microsoft Groups, documents will be migrated to this library

Teams Direct Migration

Default Value: Off

If the Teams site does not exist in the destination, keep this off so the migration uses a Prestage Teams location. This is a faster migration and more user friendly. If the destination Team site already exists, turn this on to prevent an error from occuring.

Migrate Team Channel Tabs

Default Value: Off

Migrate Team channel tabs such as: Web, Document (Word, Excel, PDF, Powerpoint). For more information, see article 'Team Channel Tabs'

Change Conditions: Disable to prevent migration of Microsoft Teams tabs.

Retry Count

Default Value: 10

The number of times an operation will be attempted before failing.

Change Conditions: Value can be changed. Can cause performance issues, not recommended.

Create Office 365 Group

Default Value: On

Create Office 365 Group if it does not exist. If a group is exists in the source but not in the destination and this is turned off the migration will fail.

Change Conditions: Turn off to not create groups.

Test Office 365 Group Email

Default Value: none

The email address of an Office 365 Group that already exists.

Change Conditions: Specify an address used to verify 365 Group settings.

Chat Message Library Name

Default Value: Documents

When migrating 'Microsoft Teams' and 'Export Chat Message Type' is set to 'Document' or 'Email and Document', the channel conversation history document will be migrated to this library.

Finalize Teams Direct Migration

Default Value: Off

Mark Teams Direct Migration as completed. Migrating Teams data with this option enabled will take Team out of the migration mode. This option opens the team and channel resources for general use by team members. No further migrations can be performed against finalized team.

Rehydrate Teams Private Chats

Default: On

Update Teams Private Chats with latest 10 exported messages.

Change Conditions: Turn off to disable the migration of Microsoft Teams 1-to-1 and 1-to-many private chats

Public Folders

1. Nest Public Folders
2. Nested Public Folder Name

Nest Public Folders

Default Value: On

Nest Public Folders under a specific top-level Public Folder.

Change Conditions: Turn off to not migrate folder nesting.

Nested Public Folder Name

{: .no_toc } Default Value: Top Level Folder

The name of the top-level Public Folder under which other Public Folders will be nested if 'Nest Public Folders' is true.

Change Conditions: Custom top level folder name can be entered.

Authentication

1. Exchange Version
2. Use Workstation Credentials

Exchange Version

Default Value: Microsoft Exchange 2019

The version of the Exchange destination platform.

Use Workstation Credentials

Default Value: Off

Use the credentials of the logged in user of the workstation to perform migrations rather than the provided username and password. The admin username and password is still required for auto-discovery.

Transfer and Performance

1. Retry Count
2. Timeout
3. Max Wait Time
4. Use X-AnchorMailbox Header

Retry Count

Default Value: 10

The number of times an operation will be attempted before failing.

Change Conditions: Value can be changed. Can cause performance issues, not recommended.

Timeout

Default Value: 1200000

The timeout that will apply to communications with the Exchange server.

Change Conditions: Value can be changed. Can cause performance issues, not recommended.

Max Wait Time

Default Value: 120000

Specify the maximum time that a wait operation can wait between exponential backoff retry attempts.

Change Conditions: Value can be changed. Can cause performance issues, not recommended.

Use X-AnchorMailbox Header

 Default Value: On

When using application impersonation, use the X-AnchorMailbox header to improve performance.

Change Conditions: Turn off to not use the X-AnchorMailbox header in import requests. Not recommended.

PowerShell

1. PowerShell Variables
2. PowerShell Init Script
3. PowerShell Before Script
4. PowerShell After Script
5. PowerShell Finalize Script
6. Run PowerShell Init Script
7. Run PowerShell Before Script
8. Run PowerShell After Script
9. Run PowerShell Finalize Script

PowerShell Variables

Default Value: [!ps-url]:https://ps.outlook.com/PowerShell-LiveID;[!o365-location]:GB;[!o365-subscription-sku]:ENTERPRISEPACK;

The collection of user-defined substitution variables that can be used in PowerShell scripts.

PowerShell Init Script

Default Value: # Set this so that errors are thrown from Cmdlets

The PowerShell script that will be run once at the start of a migration.

PowerShell Before Script

Default Value: # Set this so that errors are thrown from Cmdlets

The PowerShell script that will be run at the beginning of every user migration.

PowerShell After Script

Default Value: None

The PowerShell script that will be run at the end of every user migration.

PowerShell Finalize Script

Default Value: try{Get-PSSession | Remove-PSSession}catch

The PowerShell script that will be run when all migrations have been completed.

Run PowerShell Init Script

 Default Value: Never

Choose whether to run the PowerShell initialisation script. This script will be run once only per migration (not once per user).

Run PowerShell Before Script

{: .no_toc } Default Value: Never

Choose whether to run the PowerShell before script. This script will be run at the start of every user migration.

Run PowerShell After Script

{: .no_toc } Default Value: Never

Choose whether to run the PowerShell after script. This script will be run at the end of every user migration.

Run PowerShell Finalize Script

Default Value: Always

Choose whether to run the PowerShell finalize script. This script will be run when all migrations have completed.