Note: PowerShell integration requires a ShareGate Migrate Pro or Enterprise subscription. It is not available on the Essentials plan.
Command
Import-UserMappings
Description
Import-UserMappings imports chat user mappings from a CSV file, typically one created with Export-UserMappings.
Examples
Import chat user mappings from a file
$filePath = "c:\ChatUserMappingsToImport.csv"
$sourceConnection = Connect-MicrosoftOnline -CopyFeature ChatCopy
$destinationConnection = Connect-MicrosoftOnline -CopyFeature ChatCopy
Import-UserMappings -SourceConnection $sourceConnection -DestinationConnection $destinationConnection -Path $filePath
Import chat user mappings from the Export-UserMappings result
$filePath = "c:\ChatUserMappingsToImport.csv"
$sourceConnection = Connect-MicrosoftOnline -CopyFeature ChatCopy
$destinationConnection = Connect-MicrosoftOnline -CopyFeature ChatCopy
# Export all chat user mappings once, then reuse the file for your future import commands
Export-UserMappings -SourceConnection $sourceConnection -DestinationConnection $destinationConnection -Path $filePath
Import-UserMappings -SourceConnection $sourceConnection -DestinationConnection $destinationConnection -Path $filePath
Syntax
Import-UserMappings
-SourceConnection <IConnection>
-DestinationConnection <IConnection>
-Path <FileInfo>
Parameters
-DestinationConnection <IConnection>
Specifies the destination connection.
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-Path <FileInfo>
Specifies the .csv file path to map the source users.
Required? | True |
Default value | None |
Accept pipeline input? | True (ByValue) |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-SourceConnection <IConnection>
Specifies the source connection.
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |