.png)
Request-SPOUpgradeEvaluationSite
Published: July 16, 2012
Applies to: Office 365 | SharePoint Online
Requests to create a copy of an existing site collection for the purposes of validating the effects of upgrade without affecting the original site.
Request-SPOUpgradeEvaluationSite [-Identity] <SpoSitePipeBind> [-Confirm [<SwitchParameter>]] [-NoEmail <SwitchParameter>] [-NoUpgrade <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| Identity | Required | Microsoft.SharePoint.Online.PowerShell.SPOSitePipeBind | Specifies the SharePoint Online site collection for which you want to request a copy for the new Upgrade or Evaluation 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 an email message at the end of the upgrade evaluation site creation process. |
| NoUpgrade | Optional | System.Management.Automation.SwitchParameter | Specifies that the system not perform an upgrade as part of the evaluation site creation process. |
| 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. |
Detailed Description
The Request-SPOUpgradeEvaluationSite cmdlet lets the SharePoint Online global administrator request a copy of an existing site collection for the purposes of validating the effects of upgrade without affecting the original site.
 Note: |
|---|
| A request for an upgrade evaluation site is not automatically processed. Instead, it is scheduled to occur on the background when it causes the least effect on the service. |
You must be a SharePoint Online global administrator to run the cmdlet.
Input Types
Return Types
-------------EXAMPLE 1------------
Request-SPOUpgradeEvaluationSite http://contoso.sharepoint.com/sites/marketing
Example 1 requests a site upgrade evaluation for the marketing site http://contoso.sharepoint.com/sites/marketing using the default options of sending an email message and automatically trying to upgrade the evaluation site.
-------------EXAMPLE 2------------
Request-SPOUpgradeEvaluationSite http://contoso.sharepoint.com/sites/marketing -NoEmail $true -NoUpgrade $true
This example requests a site upgrade evaluation for the marketing site http://contoso.sharepoint.com/sites/marketing. It specifies to not send email messages and not automatically try upgrade of the evaluation site. By using the cmdlet in this way, a SharePoint Online global administrator can make changes to the upgrade evaluation site before starting the actual upgrade.
Change History
| Date | Description |
|---|---|
| July 16, 2012 | Initial publication |
