Upgrade-SPSite
对网站集启动升级过程。
语法
Default （默认值）
Upgrade-SPSite
[-Identity] <SPSitePipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Email]
[-QueueOnly]
[-Unthrottled]
[-VersionUpgrade]
[-WhatIf]
[-Priority <Byte>]
[<CommonParameters>]
说明
cmdlet Upgrade-SPSite 在网站集上启动升级过程。
cmdlet Upgrade-SPSite 为指定的 SPSite 对象激活升级过程。
您还可以使用此 cmdlet 恢复失败的升级。
在使用此 cmdlet 启动 SPSite 对象的升级时，该对象可以内部版本间升级，也可以版本间升级。
默认情况下， Upgrade-SPSite cmdlet 作为内部版本到内部版本的升级运行。
这样可防止您在修补操作后使用此 cmdlet 时，对网站集进行意外版本升级。
在版本间升级模式下，网站集运行状况检查将以修复模式运行，以确保网站集的运行状况非常良好，可以成功升级。
如果成功，将执行升级的其余部分。
有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息，请参阅 SharePoint Server cmdlet。
示例
示例 1
Upgrade-SPSite https://<site name>/sites/testsite
此示例仅使用与当前网站集作模式关联的可用生成到生成升级作来升级现有 https://< 网站名称>/网站/testsite 网站集。 此操作不会更改 SPSite.CompatibilityLevel。
示例 2
Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade
此示例使用与当前网站集作模式关联的所有可用的生成到生成升级作升级现有 https://< 网站名称>/sites/testsite 网站集，并执行版本到版本升级。
参数
-AssignmentCollection
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。
使用全局参数时，所有对象均包含在全局存储中。
如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
参数属性
| 类型: | SPAssignmentCollection |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
执行命令前，看到确认提示。
有关详细信息，请键入以下命令：get-help about_commonparameters
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定网站集升级完成时是否发送邮件。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Identity
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定要对其运行升级操作的 SPSite 对象。
参数属性
| 类型: | SPSitePipeBind |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Priority
适用：SharePoint Server 2016，SharePoint Server 2019
指定要升级站点的优先级。
有效值为：
128 - 255（低优先级）
11 - 127（普通优先级）
0 - 10（高优先级）
参数属性
| 类型: | Byte |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-QueueOnly
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定将站点放入由计时器作业管理的延迟升级的队列中。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Unthrottled
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定服务器场管理员将绕过允许网站集进行升级的限制，即使该限制中有"太多"网站集要进行升级也是如此。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-VersionUpgrade
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定对 SPSite 对象执行版本间升级。 如果设置此参数，它会在内部触发与当前网站集操作模式关联的所有可用的内部版本间操作。 随后触发版本间操作以使网站集进入下一网站集操作模式，包括与新网站集操作模式关联的所有新的内部版本间操作。 如果不设置此参数，它仅触发与当前网站集操作模式关联的可用的内部版本间升级操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
显示一条描述命令作用的消息，而不执行命令。
有关详细信息，请键入以下命令：get-help about_commonparameters
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。