Restore-SPSite

參考

模組:: SharePointServer

適用於:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

還原網站集合。

Syntax

Restore-SPSite
       [-Identity] <String>
       -Path <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-ContentDatabase <SPContentDatabasePipeBind>]
       [-Force]
       [-GradualDelete]
       [-HostHeaderWebApplication <String>]
       [-WhatIf]
       [-PreserveSiteID]
       [<CommonParameters>]

Restore-SPSite
       [-Identity] <String>
       -Path <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-DatabaseName <String>]
       [-DatabaseServer <String>]
       [-Force]
       [-GradualDelete]
       [-HostHeaderWebApplication <String>]
       [-WhatIf]
       [-PreserveSiteID]
       [<CommonParameters>]

Description

此 Cmdlet 包含一個以上的參數集。您可能只會使用到一個參數集中的參數，而且您無法合併不同參數集中的參數。如需如何使用參數集的詳細資訊，請參閱 Cmdlet 參數集。

Restore-SPSite Cmdlet 會執行將網站集合還原到 Identity 參數所指定位置的動作。內容資料庫可能僅包含一份網站集合的複本。如果是將網站集合備份與還原至相同 Web 應用程式內不同的 URL 位置，則必須提供其他內容資料庫來保留該網站集合的還原複本。

範例

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

Restore-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak

此範例會將網站集合從備份檔案 C：\Backup\site_name.bak 還原至網站集合 URL https://server_name/sites/site_name.

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

Restore-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak -Force -DatabaseServer SQLBE1 -DatabaseName SQLDB1

此範例會從備份檔案 C:\Backup\site_name.bak 中還原網站集合備份，但指定網站集合必須儲存在特定的內容資料庫中時，會覆寫 https://server_name/sites/site_name 中現有的網站集合。

----------------------範例 3----------------------

Restore-SPSite https://www.example.com -Path \\file_server\share\site_name.bak -HostHeaderWebApplication https://server_name

此範例會將網站集合備份從備份檔案 \\file_server\share\site_name.bak 還原至 Web 應用程式上的主機名稱網站集合 https://www.example.comhttps://server_name.

參數

-AssignmentCollection

管理物件以適當處置它們。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。

使用 Global 參數時，所有物件會包含在全域儲存區內。如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ContentDatabase

指定要儲存網站集合資料的 SQL Server 內容資料庫。如果未指定內容資料庫，則會使用擁有最大未使用網站集合容量且資料庫狀態已就緒的內容資料庫。

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

-DatabaseName

指定要儲存網站集合資料的 SQL Server 內容資料庫。如果未指定內容資料庫，則會使用擁有最大未使用網站集合容量且資料庫狀態已就緒的內容資料庫。

此類型必須是有效的資料庫名稱，格式為 SQLDB1。

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

-DatabaseServer

指定 DatabaseName 參數所指定之包含內容資料庫的 SQL Server 名稱。

此類型必須是格式為 SQLBE1 的有效資料庫伺服器名稱，且必須結合 DatabaseName 參數使用。

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

-Force

指定以此次還原來覆寫位於 URL 位置的現有網站集合。

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

-GradualDelete

指定要以 Force 參數覆寫的網站集合應該在一段時間內由計時器作業逐漸刪除，而不是一次全部刪除，這可降低其對 SharePoint 產品的影響，並SQL Server效能。建議針對大型網站集合使用此選項。

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

-HostHeaderWebApplication

使用備用存取對應指派給 Web 應用程式的有效 URL，例如 https://server_name

將網站集合還原為具有主機名稱的網站集合，而不是以路徑為基礎的網站集合。有 HostHeaderWebApplication 參數時， Identity 參數值是具有主機名稱之網站集合的 URL，而 HostHeaderWebApplication 參數值是保留具有主機名稱網站集合的 Web 應用程式 URL。

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

-Identity

指定要還原之網站集合的 URL 位置。

網站集合不一定非要已經位在 URL 位置才能還原。但您必須指定可建立網站集合的有效 URL 位置。網站集合若已位在指定的 URL 位置上，則您必須指定 Force 參數才能加以覆寫。

類型必須是有效的 URL，格式為 https://server_name/sites/site_name.

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

-Path

指定備份位置的有效路徑。例如 C:\Backup\site_name.bak。

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

-PreserveSiteID

保留原始網站識別碼，而不是建立新網站識別碼。

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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019