Command
New-PropertyTemplate
Syntax
New-PropertyTemplate
[-CheckInAs <CheckInAsType {SameAsCurrent | Publish | Draft}>] [-ContentApproval <ContentApprovalType {Ignore | SameAsCurrent | Approved | Rejected | Pending | Draft | Scheduled}>]
[-AuthorsAndTimestamps <SwitchParameter>] [-VersionHistory <SwitchParameter>]
[-Permissions <SwitchParameter>] [-WebParts <SwitchParameter>]
[-NoLinkCorrection <SwitchParameter>] [-FlattenFolders <SwitchParameter>]
[-VersionLimit <Int32>] [-From <DateTime>]
[-To <DateTime>] [-UserAlerts <SwitchParameter>]
New-PropertyTemplate
[-CheckInAs <CheckInAsType {SameAsCurrent | Publish | Draft}>] [-ContentApproval <ContentApprovalType {Ignore | SameAsCurrent | Approved | Rejected | Pending | Draft | Scheduled}>]
[-AuthorsAndTimestamps <SwitchParameter>] [-VersionHistory <SwitchParameter>]
[-Permissions <SwitchParameter>] [-WebParts <SwitchParameter>]
[-NoLinkCorrection <SwitchParameter>] [-FlattenFolders <SwitchParameter>]
[-VersionLimit <Int32>] [-From <DateTime>]
[-To <DateTime>] [-UserAlerts <SwitchParameter>]
[-LimitToFileExtension <String[]>]
New-PropertyTemplate
[-CheckInAs <CheckInAsType {SameAsCurrent | Publish | Draft}>] [-ContentApproval <ContentApprovalType {Ignore | SameAsCurrent | Approved | Rejected | Pending | Draft | Scheduled}>]
[-AuthorsAndTimestamps <SwitchParameter>] [-VersionHistory <SwitchParameter>]
[-Permissions <SwitchParameter>] [-WebParts <SwitchParameter>]
[-NoLinkCorrection <SwitchParameter>] [-FlattenFolders <SwitchParameter>]
[-VersionLimit <Int32>] [-From <DateTime>]
[-To <DateTime>] [-UserAlerts <SwitchParameter>]
[-ExcludeFileExtension <String[]>]
Description
The command to create a property template to copy data to a SharePoint a list or a library.
Examples
Create Property Template to Copy Content
$propertyTemplate = New-PropertyTemplate -AuthorsAndTimestamps -VersionHistory -Permissions -WebParts -NoLinkCorrection -FlattenFolders -VersionLimit 5 -CheckInAs Publish -ContentApproval SameAsCurrent -From 2012-01-01 -To 2012-12-31 $srcSite = Connect-Site -Url http://myfarm1/sites/mysourcesite $srcList = Get-List -Site $srcSite -Name mysrclist $dstSite = Connect-Site -Url http://myfarm1/sites/mydestinationsite $dstList = Get-List -Site $dstSite -Name mydstlist Copy-Content -SourceList $srcList -DestinationList $dstList -Template $propertyTemplate
Parameters
-AuthorsAndTimestamps <SwitchParameter>
Specifies that the values in the "Created By", "Created", "Modified By" and "Modified" columns will be preserved while copying.
| Required? | False |
| Position? | 2 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-CheckInAs <CheckInAsType>
Specifies the Checked-In value for documents that are copied over to SharePoint. It allow to Check In as a Draft or Published version of a document, or keep the same value as the source. It will only be used if the destination Document Library supports Versioning.
| Required? | False |
| Position? | 0 |
| Default value | SameAsCurrent |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-ContentApproval <ContentApprovalType>
Specifies the approval status value for items and documents copied over to SharePoint. It will only be used if the destination list supports Content Approval.
| Required? | False |
| Position? | 1 |
| Default value | Ignore |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-ExcludeFileExtension <String[]>
Specifies which file extensions to ignore while copying. It will only be used if the destination is a Document Library. You can split multiple extensions with commas.
| Required? | False |
| Position? | 13 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | ExcludeFileExtension |
| Aliases | None |
-FlattenFolders <SwitchParameter>
Specifies that folder hierarchy will be flatten while copying.
| Required? | False |
| Position? | 7 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-From <DateTime>
Specifies from which date the data should be copied.
Based on the built-in field "Last Modified Date".
Note: Sharegate will use the most recent data. So if a item was modified after it was created, the filter will use the modified on date, and not the created on date.
| Required? | False |
| Position? | 9 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-LimitToFileExtension <String[]>
Specifies which file extensions are included while copying. It will only be used if the destination is a Document Library. You can split multiple extensions with commas.
| Required? | False |
| Position? | 12 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | LimitToFileExtension |
| Aliases | None |
-NoLinkCorrection <SwitchParameter>
Specifies that won't correct links.
| Required? | False |
| Position? | 6 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-Permissions <SwitchParameter>
Specifies that preserve item-level permissions while migrating. If not, everything will be set to inherit permissions from its parent (which is the default behavior in SharePoint).
| Required? | False |
| Position? | 4 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-To <DateTime>
Based on the built-in field "Last Modified Date".
Specifies from and to which date the data should be copied.
Note: Sharegate will use the most recent data. So if a item was modified after it was created, the filter will use the modified on date, and not the created on date.
| Required? | False |
| Position? | 10 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-UserAlerts <SwitchParameter>
Specifies that User Alerts will be preserved while copying.
| Required? | False |
| Position? | 11 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-VersionHistory <SwitchParameter>
Specifies that preserve version history while migrating. It will only be used if versioning is enabled on the destination list or library. If the destination only allows for major versions, only the source major versions will be copied, not the draft (minor) versions.
| Required? | False |
| Position? | 3 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-VersionLimit <Int32>
Specifies to copy the X latest versions, while always conserving at least one Major version.
| Required? | False |
| Position? | 8 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
-WebParts <SwitchParameter>
Specifies that preserve WebParts when copying pages.
| Required? | False |
| Position? | 5 |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
| Parameter set name | (All) |
| Aliases | None |
Inputs
None
Outputs
PropertyTemplate
The property template.
How can we improve this article?
2 comments
What are the parameters for -Permissions? I tried False and No, but no luck. How do I prevent permissions from being migrated from a file share migration using PowerShell? I can uncheck the box in the gui, but no luck in PS as it give an error with -Permissions False or -Permissions No.
Hello Demetris,
I went ahead and created a ticket with our Support team to answer your question. You'll be in great hands!
Thanks!
Please sign in to leave a comment.