Upgrade-SPSite

对网站集启动升级过程。

语法

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

管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

使用全局参数时,所有对象均包含在全局存储中。 如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

执行命令前,看到确认提示。 有关详细信息,请键入以下命令:get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Email

指定网站集升级完成时是否发送邮件。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

指定要对其运行升级操作的 SPSite 对象。

Type:SPSitePipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Priority

指定要升级站点的优先级。

有效值为:

  • 128 - 255(低优先级)

  • 11 - 127(普通优先级)

  • 0 - 10(高优先级)

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-QueueOnly

指定将站点放入由计时器作业管理的延迟升级的队列中。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Unthrottled

指定服务器场管理员将绕过允许网站集进行升级的限制,即使该限制中有"太多"网站集要进行升级也是如此。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-VersionUpgrade

指定对 SPSite 对象执行版本间升级。 如果设置此参数,它会在内部触发与当前网站集操作模式关联的所有可用的内部版本间操作。 随后触发版本间操作以使网站集进入下一网站集操作模式,包括与新网站集操作模式关联的所有新的内部版本间操作。 如果不设置此参数,它仅触发与当前网站集操作模式关联的可用的内部版本间升级操作。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

显示一条描述命令作用的消息,而不执行命令。 有关详细信息,请键入以下命令:get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019