Backup-SPFarm

 

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

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

建立個別資料庫、Web 應用程式或整個伺服器陣列的備份。

Syntax

Backup-SPFarm -BackupMethod <String> -Directory <String> [-AssignmentCollection <SPAssignmentCollection>] [-BackupThreads <Int32>] [-ConfigurationOnly <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Item <String>] [-Percentage <Int32>] [-WhatIf [<SwitchParameter>]]

Backup-SPFarm -ShowTree <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>] [-ConfigurationOnly <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Item <String>] [-WhatIf [<SwitchParameter>]]

詳細描述

Backup-SPFarm Cmdlet 會建立整個伺服器陣列或伺服器陣列內個別元件的備份。亦可用於僅備份要做為其他 SharePoint 伺服器陣列之伺服器陣列範本使用的伺服器陣列組態設定。若要備份單一網站集合,請使用 Backup-SPSite Cmdlet。

Parameters

參數 必要 類型 描述

BackupMethod

必要

System.String

指定要建立的備份檔案類型。

執行備份時如有指定 –ShowTree 參數,即不會使用 BackupMethod 參數。

完整備份是所有選取資料的備份。差異備份是在所有選取的資料自上一次完整備份後已變更部分的備份。如果項目不支援差異備份,就會改為執行該項目的完整備份。

此類型必須是下列兩項其中之一:

- 完整

- 差異

Directory

必要

System.String

指定 SharePoint 2010 產品用於儲存其所產生之備份封裝的路徑。您如有電腦安裝了 Microsoft SQL Server 2008 與 SharePoint 2010 產品執行個體,則可以使用本機磁碟機的路徑。這包括了基本安裝。但若是將 SQL Server 2008 及 SharePoint 2010 產品安裝在多部電腦上,或您有多部伺服器執行 SharePoint 2010 產品,則必須使用通用命名慣例 (UNC) 共用路徑 (例如 \\computer_name\volume\Backup),如此 SQL Server 資料庫與搜尋元件才可寫入相同的位置。

您可以將多個備份封裝儲存在相同的位置。此路徑即是您傳送給 Restore-SPFarm Cmdlet 之 Directory 參數的路徑。

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

- C:\folder_name

- \\server_name\folder_name

注意

會自動建立 spbr* 資料夾。

ShowTree

必要

System.Management.Automation.SwitchParameter

根據傳送到 Backup-SPFarm cmdelt 的其他參數 (即 Item 參數),顯示伺服器陣列中要備份的物件。根據傳送到 Backup-SPFarm Cmdlet 的其他參數,要在備份中排除的項目前面會有星號字元 (*)。無法備份的項目則會括以方括弧 ([ ])。若有 ShowTree 參數,即不執行備份。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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

注意

使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。

BackupThreads

選用

System.Int32

指定備份過程中要使用的執行緒數目。執行緒數目愈少,愈容易讀取及瞭解備份記錄檔。執行緒數目愈多,可同時備份的元件愈多,無形中加快備份作業的速度。最小值是 1 而最大值是 10

預設值為 3

執行備份時如有指定 –ShowTree 參數,即不會使用 BackupMethod 參數。

ConfigurationOnly

選用

System.Management.Automation.SwitchParameter

若設定此項目,備份僅會包含要備份之各個物件的組態設定 (不含資料)。

Force

選用

System.Management.Automation.SwitchParameter

指定即使估算備份目錄空間不足,無法容納整個備份,亦繼續執行備份作業。

執行備份時若搭配 ShowTree 參數,即不使用 Force 參數。

Item

選用

System.String

指出要備份的伺服器陣列部分。您可以使用如 ShowTree 參數所示的完整伺服器陣列路徑標記法,或路徑中目標元件的名稱 (元件若有唯一的名稱)。同一相符項中若有多個項目,就必須提供完整路徑。預設會選取最上層節點。項目或路徑若包含空格,請括以引號。若未指定此參數,即會備份整個伺服器陣列。

此類型必須是有效的項目,例如 Farm\Microsoft SharePoint Foundation Web Application\SharePoint – 80。

Percentage

選用

System.Int32

要求按百分比增量顯示備份作業的進度更新。例如,值 5 顯示每完成 5% 即更新的備份進度,而值 10 則顯示每完成 10% 即更新的備份進度。若要顯示進度輸出,您必須指定 Verbose 參數。

注意

此百分比為估計值,所更新的實際進度可能較要求低或高。進度更新將一律記錄於備份記錄檔中。
此百分比值不是很精確,所更新的實際進度可能較要求低或高。

預設值是 5。對於體積龐大的資料庫,建議值為 1

有效值為介於 1100 之間的整數值。

WhatIf

選用

System.Management.Automation.SwitchParameter

顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

輸入類型

傳回類型

Example

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

Backup-SPFarm -Directory \\file_server\share\Backup -BackupMethod full -ConfigurationOnly

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

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

Backup-SPFarm -ShowTree -Item "Microsoft SharePoint Foundation Web Application" -Verbose

此範例會將要備份的伺服器陣列元件顯示在 [Microsoft SharePoint Foundation Web 應用程式] 節點下,實際上卻不予以備份。

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

Backup-SPFarm -Directory C:\Backup -BackupMethod full -BackupThreads 10 -Force

此範例會執行使用 10 條執行緒的伺服器陣列備份,並將此備份強制儲存到 C:\Backup 目錄,即使 SharePoint 估算可用空間不足。

See Also

Reference

Backup-SPConfigurationDatabase
Get-SPBackupHistory
Restore-SPFarm