Skip to main content
Save Content Type Mapping
Updated over 3 months ago

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

Did this answer your question?