Command
Save-ContentTypeMapping
Description
The command to save all the content type mappings for a specific source and destination list.
Examples
Save custom mappings for a source list and a destination list
# Connect to the source and destination sites
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
# Retrieve the source list from the source site
$srcList = Get-List -Name mysrclist -Site $srcSite
# Retrieve the destination list from the destination site
$dstList = Get-List -Name mydstlist -Site $dstSite
# Retrieve existing content type mappings between the source and destination lists
$mappingSettings = Get-ContentTypeMapping -SourceList $srcList -DestinationList $dstList
# Display the retrieved content type mappings
$mappingSettings
# Example initial output:
# PropertyMappings :
# ContentTypeMappings : Audio -> Audio
# Basic Page -> <NO DESTINATION>
# Document -> Document
# Folder -> Folder
# Image -> <NO DESTINATION>
# Video -> <NO DESTINATION>
# UserAndGroupMappings :
# PermissionLevelMappings :
# SiteTemplateMappings :
# Add a content type mapping from "Image" to "Picture"
$mappingSettings = Set-ContentTypeMapping -MappingSettings $mappingSettings -Source Image -Destination Picture
# Add a content type mapping from "Video" to "Movie"
$mappingSettings = Set-ContentTypeMapping -MappingSettings $mappingSettings -Source Video -Destination Movie
# Add a content type mapping for "My Custom Content Type" to ignore its destination
$mappingSettings = Set-ContentTypeMapping -MappingSettings $mappingSettings -Source "My Custom Content Type" -Ignore
# Save the updated content type mappings to the source and destination lists
$mappingSettings = Save-ContentTypeMapping -SourceList $srcList -DestinationList $dstList -MappingSettings $mappingSettings
# Retrieve the updated content type mappings to confirm changes
$mappingSettings = Get-ContentTypeMapping -SourceList $srcList -DestinationList $dstList
# Display the updated content type mappings
$mappingSettings
# Example updated output:
# PropertyMappings :
# ContentTypeMappings : Audio -> Audio
# Basic Page -> <NO DESTINATION>
# Document -> Document
# Folder -> Folder
# Image -> Picture
# My Custom Content Type -> <NO DESTINATION>
# Video -> Movie
# UserAndGroupMappings :
# PermissionLevelMappings :
# SiteTemplateMappings :
Save custom mappings for the file system and a destination list
# Connect to the destination site
$dstSite = Connect-Site -Url http://myfarm1/sites/mydestinationsite
# Retrieve the destination list from the destination site
$dstList = Get-List -Name mydstlist -Site $dstSite
# Retrieve existing content type mappings from the file system for the destination list
$mappingSettings = Get-ContentTypeMapping -FromFileSystem -DestinationList $dstList
# Display the retrieved content type mappings
$mappingSettings
# Example initial output:
# PropertyMappings :
# ContentTypeMappings : <File> -> Document
# <Folder> -> Folder
# UserAndGroupMappings :
# PermissionLevelMappings :
# SiteTemplateMappings :
# Update the content type mapping for files from the file system to map to "Picture"
$mappingSettings = Set-ContentTypeMapping -MappingSettings $mappingSettings -FileFromFileSystem -Destination Picture
# Update the content type mapping for folders from the file system to map to "Document Set"
$mappingSettings = Set-ContentTypeMapping -MappingSettings $mappingSettings -FolderFromFileSystem -Destination "Document Set"
# Save the updated content type mappings back to the destination list
$mappingSettings = Save-ContentTypeMapping -FromFileSystem -DestinationList $dstList -MappingSettings $mappingSettings
# Retrieve the updated content type mappings to confirm changes
$mappingSettings = Get-ContentTypeMapping -FromFileSystem -DestinationList $dstList
# Display the updated content type mappings
$mappingSettings
# Example updated output:
# PropertyMappings :
# ContentTypeMappings : <File> -> Picture
# <Folder> -> Document Set
# UserAndGroupMappings :
# PermissionLevelMappings :
# SiteTemplateMappings :
Syntax
Save-ContentTypeMapping-MappingSettings <MappingSettings> -SourceList <List> -DestinationList <List>
Save-ContentTypeMapping-MappingSettings <MappingSettings>-FromFileSystem <SwitchParameter> -DestinationList <List>
Parameters
-DestinationList <List>
Specifies the destination list.
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? | True |
Default value | None |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-SourceList <List>
Specifies the source list.
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | Default |
Aliases | None |