Restore-SPFarm

參考

模組:: SharePointServer

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

從備份中還原一個或多個項目。

Syntax

Restore-SPFarm
       -Directory <String>
       -RestoreMethod <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-FarmCredentials <PSCredential>]
       [-Force]
       [-Item <String>]
       [-NewDatabaseServer <String>]
       [-Percentage <Int32>]
       [-RestoreThreads <Int32>]
       [-WhatIf]
       [<CommonParameters>]

Restore-SPFarm
       -Directory <String>
       [-ShowTree]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-Item <String>]
       [-WhatIf]
       [<CommonParameters>]

Description

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

此 Restore-SPFarm Cmdlet 會從備份還原一或多個專案，例如個別資料庫、Web 應用程式或整個伺服器陣列。此 Cmdlet 也可用來將伺服器陣列範本套用至整個伺服器陣列。

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

範例

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

Restore-SPFarm -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -RestoreMethod new -ConfigurationOnly

此範例會將 \\file_server\share\Backup 目錄中的備份套件組態設定還原至伺服器陣列。

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

Restore-SPFarm -ShowTree -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -Item "Microsoft SharePoint Foundation Web Application" -Verbose

此範例顯示伺服器陣列的哪些元件會還原Microsoft SharePoint Foundation Web 應用程式節點底下，但不會實際還原它們。

-------------------EXAMPLE 3-----------------------

Restore-SPFarm -Directory C:\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef  -RestoreMethod overwrite -RestoreThreads 10 -Force

此範例會使用 10 個執行緒來還原伺服器陣列，並隱藏覆寫警告。

參數

-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

-BackupId

指定要還原的備份封裝 GUID。每個備份封裝都有相關聯的唯一 GUID。您可以使用 Get-SPBackupHistory Cmdlet 來檢視備份歷程記錄，以查看 GUID。若不指定此參數，則會使用 Directory 參數指定該路徑中最近的備份封裝。

此類型必須是格式為 12345678-90ab-cdef-1234-567890abcdef 的有效 GUID。

Type:	Guid
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

-ConfigurationOnly

指定僅還原備份封裝的設定 (沒有資料)，並將物件套用至目的地伺服器陣列。

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

-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

-Directory

指定 SharePoint 產品儲存備份套件的路徑。如果您有安裝SQL Server的電腦和 SharePoint 產品的實例，您可以使用本機磁片磁碟機路徑。這包括了基本安裝。不過，如果SQL Server和 SharePoint 產品安裝在多部電腦上，您必須使用通用命名慣例 (UNC) 共用路徑，讓SQL Server和 SharePoint 產品可以從相同的位置讀取 (，例如 \\computer_name \volume\Backup) 。

此類型必須是下列其中一個有效路徑：

C:\folder_name
\\server_name\folder_name

spbr* 資料夾會自動建立。

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

-FarmCredentials

指定要用於所有被還原元件的認證。例如，用於被還原之 Web 應用程式的應用程式集區認證。如果伺服器陣列中已有被還原的應用程式集區，則還原該應用程式集區時，就會略過 FarmCredentials 參數所指定的認證。

Type:	PSCredential
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

-Force

隱藏執行覆寫還原作業時會覆寫元件的警告提示。

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

-Item

指出要還原的備份封裝部分。您可以使用如 ShowTree 參數所示的完整伺服器陣列路徑表示法，或路徑中目標元件的名稱 (如有唯一的名稱)。如果有多個項目名稱相符，則必須提供完整路徑。如果項目或路徑包含空格，請括以雙引號。如果不存在此參數，則會還原整個備份封裝。

此類型必須是有效的項目，如：

Farm\Microsoft SharePoint Foundation Web Application\SharePoint - 80

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

-NewDatabaseServer

指定有效的 SQL 資料庫伺服器名稱。若已指定，還原作業內所有的資料庫都會以此為預設的資料庫伺服器名稱。

此參數只對新的還原有效。對覆寫還原無效。

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

-Percentage

要求按百分比增量顯示還原作業的更新進度。例如，值 5 顯示每完成 5% 更新即更新的還原進度，值 10 顯示每完成 10% 即更新的還原進度。

注意：只有在指定 -Verbose 參數時，才會在輸出中顯示進度。否則，需在還原記錄檔中查看進度。

此百分比為估計值，所更新的實際進度可能較要求低或高。

對於體積龐大的資料庫， 1 為建議值。

此類型必須是 1 到 100 之間的整數。

預設值為 5。

Type:	Int32
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

-RestoreMethod

指定要執行的還原方法。

有效的值為：

New ：指定還原內容的新位置，且要在還原至不同伺服器陣列時使用。會顯示指定新設定的其他提示。
Overwrite ：將內容與設定還原至其原始位置，且要在還原至與備份來源相同的伺服器陣列時使用。若使用 Overwrite 參數，則會顯示確認提示。若要隱藏確認提示，請使用 Force 參數。

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

-RestoreThreads

還原過程中應使用的執行緒數目。

還原執行緒愈少，愈容易了解還原記錄檔。但還原執行緒愈多，可平行還原的元件也愈多，可能會讓還原速度更快。

有效範圍介於 1 到 10 之間。預設值為 3。

Type:	Int32
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

-ShowTree

根據傳遞給 Restore-SPFarm Cmdlet 的其他參數，也就是 Item 和 ConfigurationOnly 參數，顯示要還原伺服器陣列中的哪些物件。根據傳遞至 Restore-SPFarm Cmdlet 的其他參數從還原中排除的專案，會在前面加上星號 (*) 。無法還原的項目會括以方括弧 ([ ])。若有 ShowTree 參數，即不執行還原作業。

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

共用方式為