Backup-SPFarm

參考

模組:: SharePointServer

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

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

Syntax

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

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

Description

此 Cmdlet 包含一個以上的參數集。您可能只使用一個參數集中的參數，但不可以結合不同參數集的參數。如需如何使用參數集的詳細資訊，請參閱 Cmdlet 參數集。

Backup-SPFarm Cmdlet 會為伺服器陣列內的整個伺服器陣列或個別元件建立備份。它也可以用來只備份伺服器陣列的組態設定，以作為其他 SharePoint 伺服器陣列的伺服器陣列範本。如果您想要備份單一網站集合，請使用 Backup-SPSite Cmdlet。

若要查看要備份的可用物件，請使用 -ShowTree 參數集。

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

範例

--------------------範例 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 估算可用空間不足。

--------------------EXAMPLE 4---------------------

Backup-SPFarm -ShowTree

這個範例會顯示可用來備份的 Backup-SPFarm 物件。

參數

-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

-BackupMethod

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

如果使用 -ShowTree 參數執行備份，則不會使用 BackupMethod 參數。

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

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

完整
微分

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

-BackupThreads

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

預設值為 3。

如果使用 -ShowTree 參數執行備份，則不會使用 BackupMethod 參數。

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

-ConfigurationOnly

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

SharePoint 可能會高估僅限設定備份所需的空間量，這可能會導致 SharePoint 估計它沒有足夠的空間可將備份儲存在指定的路徑。 -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

-Confirm

執行 Cmdlet 之前提示您確認。

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 產品安裝在多部電腦上，或如果您有多部執行 SharePoint 產品的伺服器，您必須使用通用命名慣例 (UNC) 共用路徑，讓SQL Server資料庫和搜尋元件寫入相同的位置，例如 \\computer_name\volume\Backup) 。

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

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

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

-Force

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

執行備份時若搭配 ShowTree 參數，即不使用 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

-Percentage

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

此百分比為估計值，所更新的實際進度可能較要求低或高。進度更新一律會記錄在備份記錄檔中。

百分比值不是中國，而實際進度更新可能低於或高於要求。

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

有效值為介於 1 到 100 之間的整數值。

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

根據傳送到 Backup-SPFarm cmdelt 的其他參數 (即 Item 參數)，顯示伺服器陣列中要備份的物件。根據傳送到 Backup-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

共用方式為