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.
Index
Examples
Promote to a new M365 Group
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -Browser Copy-Promote -Tenant $tenant -SubsiteUrl "https://mytenant.sharepoint.com/sites/mysite/subsite" -WebTemplateName "GROUP#0"
Promote on-premises with Precheck
$farm = Connect-Site http://myfarmCentralAdmin1 Copy-Promote -Farm $farm -SubsiteUrl http://myfarm1/sites/mysite/subsite -WhatIf
Promote on M365 with Precheck
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -Browser Copy-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-admin.sharepoint.com" -UseCredentialsFrom $tenant $promote = Copy-Promote -Tenant $tenant -SubsiteUrl $subsite Remove-Site $subsite
Promote with specified administrators
$tenant = Connect-Site -Url "https://mytenant-admin.sharepoint.com" -Browser Copy-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" -Browser Copy-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
-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? | 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 |