Articles in this section

Get User and Group Mapping

Updated
Follow

Command

Get-UserAndGroupMapping

Description

The command to get the user and group mappings from a source site and a destination site.

Index

Examples

Get mappings from a source site and a destination site

$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite" 
$mappingSettings = Get-UserAndGroupMapping -SourceSite $srcSite -DestinationSite $dstSite 
$mappingSettings  
PropertyMappings        : 
ContentTypeMappings     : 
UserAndGroupMappings    :  CustomPermissions Members -> Sales&Marketing Owners
                           i:0#.w|office\sg.achille  -> i:0#.w|office\sg.baptiste
                           i:0#.w|office\sg.camille  -> i:0#.w|office\sg.denis
PermissionLevelMappings : 
SiteTemplateMappings    :

Get mappings from the file system and a destination site

$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$mappingSettings = Get-UserAndGroupMapping -FromFileSystem -DestinationSite $dstSite 
$mappingSettings 
PropertyMappings        : 
ContentTypeMappings     : 
UserAndGroupMappings    :  OFFICE\Employee   -> Sales&Marketing Owners
                           OFFICE\sg.achille -> i:0#.w|office\sg.baptiste
                           OFFICE\sg.camille -> i:0#.w|office\sg.denis
PermissionLevelMappings : 
SiteTemplateMappings    :

Merge mappings with mappings from a source site and a destination site

$mappingSettings = Set-UserAndGroupMapping -Source "John Doe" -Destination "Paul Smith" 
$mappingSettings = Set-UserAndGroupMapping -MappingSettings $mappingSettings -Source "myusername" -Destination "anotherusername"
$mappingSettings = Set-UserAndGroupMapping -MappingSettings $mappingSettings -UnresolvedUserOrGroup -Destination "Old employee Group" 
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$mappingSettings = Get-UserAndGroupMapping -MappingSettings $mappingSettings -SourceSite $srcSite -DestinationSite $dstSite 
$mappingSettings  
PropertyMappings        : 
ContentTypeMappings     : 
UserAndGroupMappings    :  <Unresolved users or groups> -> Old employee Group
                           CustomPermissions Members    -> Sales&Marketing Owners
                           i:0#.w|office\sg.achille     -> i:0#.w|office\sg.baptiste
                           i:0#.w|office\sg.camille     -> i:0#.w|office\sg.denis
                           John Doe                     -> Paul Smith
                           myusername                   -> anotherusername  
PermissionLevelMappings : 
SiteTemplateMappings    :

Syntax

Get-UserAndGroupMapping
-SourceSite <Site> 
-DestinationSite <Site>
[-MappingSettings <MappingSettings>]

Get-UserAndGroupMapping
-FromFileSystem <SwitchParameter>
-DestinationSite <Site>
[-MappingSettings <MappingSettings>]

Parameters

-DestinationSite <Site>

Specifies the destination site.

Required? True
Default value None
Accept pipeline input? False
Accept wildcard characters? False
Parameter set name (All)
Aliases None

-FromFileSystem <SwitchParameter>

Specifies that the source is the file system.

Required? True
Default value None
Accept pipeline input? False
Accept wildcard characters? False
Parameter set name FileSystem
Aliases None

-MappingSettings <MappingSettings>

Specifies the mapping settings.

Required? False
Default value None
Accept pipeline input? True (ByValue, ByPropertyName)
Accept wildcard characters? False
Parameter set name (All)
Aliases None

-SourceSite <Site>

Specifies the source site.

Required? True
Default value None
Accept pipeline input? False
Accept wildcard characters? False
Parameter set name Default
Aliases None

Related articles