Restore-SPFarm

發行項
03/07/2017

適用版本： SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間： 2015-03-09

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

Syntax

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

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

詳細描述

Restore-SPFarm Cmdlet 可從備份中還原一個或多個項目，例如個別的資料庫、Web 應用程式或整個伺服器陣列。此 Cmdlet 亦可用於將伺服器陣列範本套用至整個伺服器陣列。

Parameters

參數	必要	類型	描述
Directory	選用	System.String	指定 SharePoint 2010 產品用於儲存備份封裝的路徑。您的電腦若安裝 Microsoft SQL Server 2008 與 SharePoint 2010 產品執行個體，就可以使用本機磁碟機路徑。這包括基本安裝。不過，如果 SQL Server 2008 及 SharePoint 2010 產品安裝在多部電腦上，則必須使用通用命名慣例 (UNC) 共用路徑，讓 SQL Server 2008 及 SharePoint 2010 產品可從相同的位置 (例如 \\computer_name\volume\Backup) 讀取。此類型必須是下列其中一個有效路徑： - C:\folder_name - \\server_name\folder_name 注意會自動建立 spbr* 資料夾。
RestoreMethod	選用	System.String	指定要執行的還原方法。有效值如下： - New：指定還原內容的新位置，且要在還原至不同伺服器陣列時使用。會顯示指定新設定的其他提示。 - Overwrite：將內容與設定還原至其原始位置，且要在還原至與備份來源相同的伺服器陣列時使用。若使用 Overwrite 參數，則會顯示確認提示。若要隱藏確認提示，請使用 Force 參數。
ShowTree	選用	System.Management.Automation.SwitchParameter	根據傳送到 Restore-SPFarm Cmdlet 的其他參數 (即 Item 及 ConfigurationOnly 參數)，顯示伺服器陣列中要還原的物件。根據傳送到 Restore-SPFarm Cmdlet 的其他參數，前面有星號字元 () 的項目則不予以還原。無法還原的項目會括以方括弧 ([ ])。若有 ShowTree* 參數，即不執行還原作業。
AssignmentCollection	選用	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。注意使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。
BackupId	選用	System.Guid	指定要還原的備份封裝 GUID。每個備份封裝都有相關聯的唯一 GUID。使用 Get-SPBackupHistory Cmdlet 檢視備份歷程記錄，即可看到 GUID。若不指定此參數，則會使用 Directory 參數指定該路徑中最近的備份封裝。此類型必須是格式為 12345678-90ab-cdef-1234-567890abcdef 的有效 GUID。
ConfigurationOnly	選用	System.Management.Automation.SwitchParameter	指定僅還原備份封裝的設定 (沒有資料)，並將物件套用至目的地伺服器陣列。
Confirm	選用	System.Management.Automation.SwitchParameter	執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters
FarmCredentials	選用	System.Management.Automation.PSCredential	指定要用於所有被還原元件的認證。例如，用於被還原之 Web 應用程式的應用程式集區認證。如果伺服器陣列中已有被還原的應用程式集區，則還原該應用程式集區時，就會略過 FarmCredentials 參數所指定的認證。
Force	選用	System.Management.Automation.SwitchParameter	隱藏執行覆寫還原作業時會覆寫元件的警告提示。
Item	選用	System.String	指出要還原的備份封裝部分。您可以使用如 ShowTree 參數所示的完整伺服器陣列路徑表示法，或路徑中目標元件的名稱 (如有唯一的名稱)。如果有多個項目名稱相符，則必須提供完整路徑。如果項目或路徑包含空格，請括以雙引號。如果不存在此參數，則會還原整個備份封裝。此類型必須是有效的項目，如： Farm\Microsoft SharePoint Foundation Web Application\SharePoint - 80
NewDatabaseServer	選用	System.String	指定有效的 SQL 資料庫伺服器名稱。若已指定，還原作業內所有的資料庫都會以此為預設的資料庫伺服器名稱。此參數只對新的還原有效。對覆寫還原無效。
Percentage	選用	System.Int32	要求按百分比增量顯示還原作業的更新進度。例如，值 5 顯示每完成 5% 更新即更新的還原進度，值 10 顯示每完成 10% 即更新的還原進度。附註：指定 -Verbose 參數時，進度才會顯示在輸出中。否則，需在還原記錄檔中查看進度。此百分比為估計值，所更新的實際進度可能較要求低或高。對於體積龐大的資料庫，1 為建議值。此類型必須是 1 到 100 之間的整數。預設值為 5。
RestoreThreads	選用	System.Int32	還原過程中應使用的執行緒數目。還原執行緒愈少，愈容易了解還原記錄檔。但還原執行緒愈多，可平行還原的元件也愈多，可能會讓還原速度更快。有效範圍介於 1 到 10 之間。預設值為 3。
WhatIf	選用	System.Management.Automation.SwitchParameter	顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters

輸入類型

傳回類型

Example

-------------------範例 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 Application 節點下要還原的伺服器陣列元件，但不會真的還原它們。

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

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

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