Commands › SharePoint Online

Request-SPOUpgradeEvaluationSite

SharePoint Online Microsoft.Online.SharePoint.PowerShell Request-*

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

Quick start script

# Request-SPOUpgradeEvaluationSite — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-SPOService -Url https://$org-admin.sharepoint.com

# 2. Run and inspect
Request-SPOUpgradeEvaluationSite -Identity <SpoSitePipeBind> | Format-List

# 3. Export for evidence / drift tracking
Request-SPOUpgradeEvaluationSite | Export-Clixml .\SPOUpgradeEvaluationSite-$(Get-Date -Format yyyyMMdd).xml

Syntax

Request-SPOUpgradeEvaluationSite -Identity <SpoSitePipeBind> [-NoUpgrade] [-NoEmail] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Parameters (5)

Parameter	Type	Required	What it controls
-Identity	SpoSitePipeBind	yes	Specifies the SharePoint Online site collection for which you want to request a copy for the new Upgrade or Evaluation site collection.
-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.
-NoUpgrade	SwitchParameter		Specifies that the system not perform an upgrade as part of the evaluation site creation process.
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-WhatIf	SwitchParameter		Shows what would happen if the cmdlet runs. The cmdlet is not run.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.