Upgrade-SPSite
在網站集合上啟動升級程序。
語法
Default (預設值)
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 物件上起始升級時，此物件可以是組建對組建或版本對版本的升級。
根據預設，Cmdlet Upgrade-SPSite 會作為組建對組建升級運作。
如果您在修補作業之後使用此 Cmdlet，這可防止非預期的網站集合版本升級。
在版本對版本升級模式中，網站集合健康情況檢查會以修復模式執行，以確保網站集合的狀況良好，足以順利升級。
如果成功，則會進行升級的其餘部分。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
範例 1
Upgrade-SPSite https://<site name>/sites/testsite
此範例只會使用與目前網站集合作業模式相關聯的可用組建對組建升級動作，來升級現有的 https://< 網站名稱>/sites/testsite 網站集合。 此作業不會變更 SPSite.CompatibilityLevel。
範例 2
Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade
本範例會使用與目前網站集合作業模式相關聯的所有可用組建對組建升級動作，來升級現有的 https://< 網站名稱>/月臺/testsite 網站集合，並執行版本對版本升級。
參數
-AssignmentCollection
適用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 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。