Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Request-SPOUpgradeEvaluationSite

Request-SPOUpgradeEvaluationSite

microsoft.online.sharepoint.powershell.dll, microsoft.online.sharepoint.powershell-1.dll

Synopsis

Requests to create a copy of an existing site collection for the purposes of validating the effects of upgrade without affecting the original site.

Syntax

Request-SPOUpgradeEvaluationSite [-Identity] [-Confirm] [-NoEmail] [-NoUpgrade] [-WhatIf] [<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.

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.

For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at http://go.microsoft.com/fwlink/p/?LinkId=251832 (http://go.microsoft.com/fwlink/p/?LinkId=251832).

Parameters

-Identity <SpoSitePipeBind>

Specifies the SharePoint Online site collection for which you want to request a copy for the new Upgrade or Evaluation site collection.

Aliases

None

Required?

True

Position

1

Default value

Accept pipeline input?

True

Accept wildcard characters?

False

-Confirm <SwitchParameter>

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

Aliases

None

Required?

False

Position

Named

Default value

Accept pipeline input?

False

Accept wildcard characters?

False

-NoEmail <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.

Aliases

None

Required?

False

Position

Named

Default value

Accept pipeline input?

False

Accept wildcard characters?

False

-NoUpgrade <SwitchParameter>

Specifies that the system not perform an upgrade as part of the evaluation site creation process.

Aliases

None

Required?

False

Position

Named

Default value

Accept pipeline input?

False

Accept wildcard characters?

False

-WhatIf <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.

Aliases

None

Required?

False

Position

Named

Default value

Accept pipeline input?

False

Accept wildcard characters?

False

Input Type

Return Type

Notes

None

Examples

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

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.

C:\PS>Request-SPOUpgradeEvaluationSite http://contoso.sharepoint.com/sites/marketing

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

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.

C:\PS>Request-SPOUpgradeEvaluationSite http://contoso.sharepoint.com/sites/marketing -NoEmail $true -NoUpgrade $true

Introduction to the SharePoint Online management shell
Set up the SharePoint Online Management Shell Windows PowerShell environment
Upgrade-SPOSite