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 Subscription Edition |
-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 Subscription Edition |
-ConfigurationOnly
指定僅還原備份封裝的設定 (沒有資料),並將物件套用至目的地伺服器陣列。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-FarmCredentials
指定要用於所有被還原元件的認證。 例如,用於被還原之 Web 應用程式的應用程式集區認證。 如果伺服器陣列中已有被還原的應用程式集區,則還原該應用程式集區時,就會略過 FarmCredentials 參數所指定的認證。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Force
隱藏執行覆寫還原作業時會覆寫元件的警告提示。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-NewDatabaseServer
指定有效的 SQL 資料庫伺服器名稱。 若已指定,還原作業內所有的資料庫都會以此為預設的資料庫伺服器名稱。
此參數只對新的還原有效。 對覆寫還原無效。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |