Articles in this section

Get Permission Level Mapping

Updated
Follow

Name

Get-PermissionLevelMapping

SYNTAX

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

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

DESCRIPTION

The command to get the permission level mappings from a source and destination site pair.

PARAMETERS

-DestinationSite <Site>

Specifies the destination site.

Required? True
Position? 2
Default value  
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
Position? 1
Default value  
Accept pipeline input? false
Accept wildcard characters? False
Parameter set name FileSystem
Aliases None

-MappingSettings <MappingSettings>

Specifies the mapping settings.

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

-SourceSite <Site>

Specifies the source site.

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

INPUTS

MappingSettings

OUTPUTS

MappingSettings

The mapping settings merged with the permission level mappings from a source and destination site pair.

EXAMPLES

-------------- Example: 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-PermissionLevelMapping -SourceSite $srcSite -DestinationSite $dstSite
$mappingSettings
PropertyMappings        :
ContentTypeMappings     :
UserAndGroupMappings    :
PermissionLevelMappings : Approve              -> Approve
                          Contribute           -> Contribute
                          Design               -> Design
                          Full Control         -> Full Control
                          My Custom Permission -> <NO DESTINATION>
                          Read                 -> Read
                          View Only            -> View Only
SiteTemplateMappings    :

-------------- Example: Get mappings from the file system and a destination site --------------

$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$mappingSettings = Get-PermissionLevelMapping -FromFileSystem -DestinationSite $dstSite
$mappingSettings
PropertyMappings        :
ContentTypeMappings     :
UserAndGroupMappings    :
PermissionLevelMappings : Full Control   -> Full Control
                          Modify         -> Contribute
                          Read & execute -> Read
                          Read           -> Read
                          Write          -> Contribute
SiteTemplateMappings    :

-------------- Example: Merge mappings with mappings from a source site and a destination site --------------

$mappingSettings = Set-PermissionLevelMapping -Source "My Custom Permission" -Destination "Full Control"
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
$mappingSettings = Get-PermissionLevelMapping -MappingSettings $mappingSettings -SourceSite $srcSite -DestinationSite $dstSite
$mappingSettings
PropertyMappings        :
ContentTypeMappings     :
UserAndGroupMappings    :
PermissionLevelMappings : Approve              -> Approve
                          Contribute           -> Contribute
                          Design               -> Design
                          Full Control         -> Full Control
                          My Custom Permission -> Full Control
                          Read                 -> <NO DESTINATION>
                          View Only            -> View Only
SiteTemplateMappings    :

 

Related articles