Note: PowerShell integration requires a ShareGate Migrate Pro or Enterprise subscription. It is not available on the Essentials plan.
Command
Copy-Promote
Description
The command to promote a subsite as a Site Collection.
Note: The promotion of your subsite is done with a migration. The original subsite is preserved at the source after the operation.
Examples
Promote to a new M365 Group
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -BrowserCopy-Promote -Tenant $tenant -SubsiteUrl "https://mytenant.sharepoint.com/sites/mysite/subsite" -WebTemplateName "GROUP#0"
Promote on-premises with Precheck
$farm = Connect-Site http://myfarmCentralAdmin1Copy-Promote -Farm $farm -SubsiteUrl http://myfarm1/sites/mysite/subsite -WhatIf
Promote on M365 with Precheck
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -BrowserCopy-Promote -Tenant $tenant -SubsiteUrl "https://mytenant.sharepoint.com/sites/mysite/subsite" -WhatIf
Promote with delete source
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -Browser$subsite = Connect-Site -Url "https://mytenant.sharepoint.com/sites/mysite/subsite" -UseCredentialsFrom $tenant$promote = Copy-Promote -Tenant $tenant -SubsiteUrl $subsiteRemove-Site $subsite
Promote with specified administrators
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -BrowserCopy-Promote -Tenant $tenant -SubsiteUrl "https://mytenant.sharepoint.com/sites/mysite/subsite" -Administrators "user1", "user2", "user3"
Promote with specified name and URL
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -BrowserCopy-Promote -Tenant $tenant -SubsiteUrl "https://mytenant.sharepoint.com/sites/mysite/subsite" -SiteTitle "site title at the destination" -SiteTitleUrlSegment "mynewsite"
Syntax
Copy-Promote
-Farm <Site>-SubsiteUrl <String>[-Administrators <String[]>][-WebTemplateName <String>][-NormalMode <SwitchParameter>][-WhatIf <SwitchParameter>][-TaskName <String>]
Copy-Promote
-Farm <Site>-SubsiteUrl <String>-SiteTitleUrlSegment <String>-SiteTitle <String>[-Administrators <String[]>][-WebTemplateName <String>][-NormalMode <SwitchParameter>][-WhatIf <SwitchParameter>][-TaskName <String>]Parameters
Parameters
-Administrators <String[]>
Specifies the values to use when searching for users to set as the new site collection's administrators.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-Farm <Site>
Specifies the farm or tenant to promote to.
Required? | False |
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | Tenant |
-NormalMode <SwitchParameter>
Specifies that the normal mode should be used. Note: Insane mode is always used by default in PowerShell.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-SiteTitle <String>
Specifies the title of the new site collection. This parameter must be used with the 'SiteTitleUrlSegment' parameter.
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | SpecifySiteTitle |
Aliases | None |
-SiteTitleUrlSegment <String>
Specifies the new site URL that is relative to its managed path. This parameter must be used with the 'SiteTitle' parameter.
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | SpecifySiteTitle |
Aliases | None |
-SubsiteUrl <String>
Specifies the subsite to promote.
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-TaskName <String>
Specifies a name for the task.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-WebTemplateName <String>
Specifies the template name of the new site collection.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-WhatIf <SwitchParameter>
Specifies that a pre-check will be executed instead of a migration
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |