Backup-SPConfigurationDatabase

リファレンス

モジュール:: sharepoint-server

適用対象:: SharePoint Server Subscription Edition

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

構文

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 Subscription Edition

-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 Subscription Edition

-DatabaseName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseServer

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

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

Type:	String
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 製品のインスタンスがインストールされているコンピューターがある場合は、ローカルドライブパスを使用できます。 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 Subscription Edition

-Item

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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 Subscription Edition