共用方式為


Restore-SPFarm

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

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