Upgrade-SPSite

在網站集合上啟動升級程序。

Syntax

Upgrade-SPSite
       [-Identity] <SPSitePipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Email]
       [-QueueOnly]
       [-Unthrottled]
       [-VersionUpgrade]
       [-WhatIf]
       [-Priority <Byte>]
       [<CommonParameters>]

Description

Upgrade-SPSite Cmdlet 會在網站集合上啟動升級程序。

Upgrade-SPSite Cmdlet 會啟動指定 SPSite 物件的升級程序。 您也可以使用此 Cmdlet 以繼續失敗的升級程序。 當您使用此 Cmdlet 以在 SPSite 物件上起始升級時,此物件可以是組建對組建或版本對版本的升級。

By default, the Upgrade-SPSite cmdlet operates as a build-to-build upgrade. This prevents unexpected version upgrades of site collections if you use this cmdlet after a patching operation. When in version-to-version upgrade mode, site collection health checks are run in repair mode to ensure that the site collection is healthy enough to upgrade successfully. If successful, the remainder of the upgrade occurs.

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱位於 SharePoint Server Cmdlets 的線上文件。

範例

-------------範例 1----------

Upgrade-SPSite https://<site name>/sites/testsite

This example upgrades the existing https://<site name>/sites/testsite site collection by using only build-to-build upgrade actions. The SPSite.CompatibilityLevel will not be changed by this operation.

-------------範例 2----------

Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade

This example upgrades the existing https://<site name>/sites/testsite site collection by using only build-to-build upgrade actions. The SPSite.CompatibilityLevel will not be changed by this operation.

參數

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Email

指定在網站集合升級完成時,是否要傳送郵件。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

指定要執行升級作業的 SPSite 物件。

Type:SPSitePipeBind
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Priority

指定用來升級網站的優先順序。

有效的值為:

  • 128-255 (低優先順序)

  • 11-127 (一般優先順序)

  • 0-10 (高優先順序)

Type:Byte
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-QueueOnly

指定要將網站放到佇列中,以便進行由計時器工作所管理的延遲升級。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Unthrottled

指定伺服器陣列管理員,以略過允許網站集合升級的節流,即使節流中有「太多」網站集合要升級也一樣。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-VersionUpgrade

Specifies to perform a version-to-version upgrade on the SPSite object. When this parameter is set, it internally triggers all available build-to-build actions that are associated with the current site collection operating mode. Version-to-version actions follow to bring site collections to the next site collection operating mode inclusive of all new build-to-build actions that are associated with the new site collection operating mode. When this parameter is not set, it triggers only available build-to-build upgrade actions that are associated with the current site collection operating mode.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition