Export (0) Print
Expand All

Upgrade-SPOSite

 

Applies to: SharePoint Online, Office 365

Topic Last Modified: 2014-07-17

Starts the upgrade process on a site collection.

Upgrade-SPOSite [-Identity] <SPOSitePipeBind> [-VersionUpgrade] [-NoEmail] [-WhatIf] [-Confirm] 

The Upgrade-SPOSite cmdlet activates the upgrade process for the specified SharePoint Online site collection. This cmdlet can also be used to resume failed upgrades.

When upgrade is initiated, it can either be a build-to-build or version-to-version upgrade. The default is build-to-build upgrade. When in version-to-version upgrade, site collection health checks are first run in repair mode to ensure that the site collection can be upgraded successfully.

You must be a SharePoint Online global administrator and a site collection administrator to run the cmdlet.

 

Parameter Required Type Description

Identity

Required

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Specifies the SharePoint Online site collection to upgrade.

VersionUpgrade

Optional

System.Management.Automation.SwitchParameter

Specifies whether to perform a version-to-version upgrade on the site collection. When this parameter is set, it internally triggers any available build-to-build upgrade associated with the current site collection operating mode, and continues with version-to-version upgrade. When this parameter is not set, it triggers only build-to-build upgrade on the site collection.

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters.

NoEmail

Optional

System.Management.Automation.SwitchParameter

Specifies that the system not send the requester and site collection administrators a notification e-mail message at the end of the upgrade process.

QueueOnly

Optional

System.Management.Automation.SwitchParameter

Adds the site collection to the upgrade queue. The upgrade does not occur immediately.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters.

-------------EXAMPLE 1----------

Upgrade-SPOSite -Identity https://contoso.sharepoint.com/sites/marketing

Example 1 runs a build-to-build upgrade of the existing site collection https://contoso.sharepoint.com/sites/marketing. The CompatibilityLevel property associated with the site collection is not changed by this operation. For more information about CompatibilityLevel, see New-SPOSite.

-------------EXAMPLE 2----------

Upgrade-SPOSite -Identity https://contoso.sharepoint.com/sites/marketing -VersionUpgrade

Example 2 runs a version-to-version upgrade of the existing site collection https://contoso.sharepoint.com/sites/marketing. The CompatibilityLevel property associated with the site collection is changed to a value of SharePoint 2013 by this operation. For more information about CompatibilityLevel, see New-SPOSite.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft