Backup-SPConfigurationDatabase

ファームレベルの構成のみをバックアップします。

構文

Backup-SPConfigurationDatabase
      -Directory <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [<CommonParameters>]
Backup-SPConfigurationDatabase
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [-ShowTree]
      [<CommonParameters>]

説明

このコマンドレットには、複数のパラメーター セットが含まれています。 使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。 パラメーター セットの使用法に関する詳しい情報については、「コマンドレットのパラメーター セット」を参照してください。

Backup-SPConfigurationDatabase コマンドレットでは、現在のファームの構成のみか、現在のファームに接続していない独立した構成データベースの構成のみをバックアップします。 現在のファームの構成のみをバックアップする場合は、DatabaseServer パラメーターと DatabaseName パラメーターを指定する必要はありません。 ただし、このようなシナリオでは、Backup-SPFarm コマンドレットと ConfigurationOnly パラメーターを使用することをお勧めします。

管理者がファーム構成テンプレートを作成して構成をバックアップすると、Restore-SPFarm コマンドレットで復元することにより、そのファーム構成テンプレートを他の SharePoint ファームに適用できます。

SharePoint 製品のWindows PowerShellに関するアクセス許可と最新の情報については、 のオンライン ドキュメントを参照してくださいhttps://go.microsoft.com/fwlink/p/?LinkId=251831

------------------- 例 1 --------------------

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -ShowTree

この例では、構成のみのバックアップに含めることができるコンポーネントを表示します。

------------------- 例 2 --------------------

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -Verbose

この例では、構成のみのバックアップを実行し、詳細情報を表示します。

パラメーター

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

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

-DatabaseCredentials

SQL Server データベースの管理者のユーザー名に対応する ID およびパスワードを指定します。

このパラメーターは、SQL 認証を使用してデータベースに接続する場合にのみ指定する必要があります。 Windows 認証を使用してデータベースに接続する場合は、このパラメーターを指定しないでください。

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

-DatabaseName

構成データベース名を指定します。

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

-DatabaseServer

構成データベースを含む SQL データベース サーバーを指定します。 既定値はローカル コンピューター名です。

この型は、有効なデータベース サーバー (DS など) であることが必要です。

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

-Directory

SharePoint 製品が生成するバックアップ パッケージを格納するパスを指定します。 SQL Serverと SharePoint 製品のインスタンスがインストールされているコンピューターがある場合は、ローカル ドライブ パスを使用できます。 This includes a basic installation. ただし、SQL Serverと SharePoint 製品が複数のコンピューターにインストールされている場合、または SharePoint 製品を実行しているサーバーが複数ある場合は、SQL Server データベースと検索コンポーネントが同じ場所 (\\computer_name\volume\Backup など) に書き込まれるように、汎用名前付け規則 (UNC) 共有パスを使用する必要があります。

複数のバックアップ パッケージを同じ場所に格納することができます。 これは、 Restore-SPFarm コマンドレットの 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

-Item

ファーム内のバックアップする部分を指定します。 ShowTree パラメーターで表示されるファームの完全パスを使用するか、パス内の対象コンポーネント名 (一意である場合) を使用できます。 同じ名前のアイテムが複数ある場合は、完全パスを指定する必要があります。 アイテム名またはパスにスペースが含まれる場合は引用符で囲みます。

Item パラメーターを指定しない場合は、ファーム構成全体がバックアップされます。

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

-ShowTree

バックアップ コマンドレットに渡す他のパラメーターに基づいてファーム内のバックアップするオブジェクト ( Item ) を表示します。 Backup-SPConfigurationDatabase コマンドレットに渡す他のパラメーターに基づいてバックアップから除外されるアイテムには、前にアスタリスク文字 (*) が付きます。 バックアップできないアイテムは角かっこ ([ ]) で囲まれます。 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