Microsoft Teams

Refer to the following sections to configure user mappings for Microsoft Teams to Microsoft Teams / Google Chat Space migrations.

Microsoft Teams to Microsoft Teams

Refer to the following table to view the supported user/group mappings:

Source User TypeDestination User TypeMapping ValueExampleComment
Microsoft 365 UsersMicrosoft 365 Userslogin name – login nameuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value only supports the user principal name. contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.
ADFS UsersADFS Userslogin name – login nameuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value only supports the user principal name. contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.
Guest UsersGuest Usersemail address – email addressuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value supports both the user principal name and email address. Contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.
Guest UsersGuest Userslogin name – login nameuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value supports both the user principal name and email address. Contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.
Guest UsersMicrosoft 365 Usersemail address – login nameuser@contoso1.onmicrosoft.comuser@contoso2.onmicrosoft.comThe destination mapping value only supports the user principal name. contoso1.onmicrosoft.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.
External UsersMicrosoft 365 Usersemail address – login nameuser@contoso1.comuser@contoso2.onmicrosoft.comThe destination mapping value only supports the user principal name. contoso1.com represents the domain name of your source user, while contoso2.onmicrosoft.com represents the domain name of your destination user.

For the supported mapping values and examples of team site users, refer to the table in the SharePoint Online section.

For the supported mapping values and examples of Exchange email’s To and Cc users, refer to the table in the Exchange Online section.

Microsoft Teams to Google Chat Space

Refer to the following table to view the supported user/group mappings:

Source User TypeDestination User TypeMapping ValueExampleComment
Microsoft 365 UsersGoogle Userslogin name – login nameuser@contoso.onmicrosoft.com - user@contosogsuite.comuser@contoso.onmicrosoft.com represents the login name of a source user. user@contosogsuite.com represents the login name of a user in your destination Google workspace.
Guest user/External userExternal Userlogin name – login nameuser@contoso.onmicrosoft.com - user@contosogsuite.comuser@contoso.onmicrosoft.com represents the login name of a source user. user@contosogsuite.com represents the login name of a user in your destination Google Workspace.
Guest user/External userInternal Userlogin name – login nameuser@contoso.onmicrosoft.com - user@contosogsuite.comuser@contoso.onmicrosoft.com represents the login name of a source user. user@contosogsuite.com represents the login name of a user in your destination Google Workspace.
Microsoft 365 GroupGoogle Grouplogin name – login namegroup@contoso.onmicrosoft.com - group@contosogsuite.comgroup@contoso.onmicrosoft.com represents the login name of a source group. group@contosogsuite.com represents the login name of a Google group in your destination Google Workspace.
Mail-enabled Security GroupGoogle Grouplogin name – login namegroup@contoso.onmicrosoft.com - group@contosogsuite.comgroup@contoso.onmicrosoft.com represents the login name of a source group. group@contosogsuite.com represents the login name of a Google group in your destination Google Workspace.
Microsoft 365 Security GroupGoogle Groupdisplay name – login nameContoso Group – group@contosogsuite.comContoso Group represents the display name of a source group, while the source domain is contoso.onmicrosoft.com. group@contosogsuite.com represents the login name of a Google group in your destination Google Workspace.
SharePoint GroupGoogle Groupspgroup:display name - login namespgroup:Contoso Group - group@contosogsuite.comContoso Group represents the display name of a source group, while the source domain is contoso.onmicrosoft.com. group@contosogsuite.com represents the login name of a Google group in your destination Google Workspace.