Restore-SPEnterpriseSearchServiceApplication

リファレンス

モジュール:: sharepoint-server

適用対象:: SharePoint Server Subscription Edition

検索アプリケーションのサードパーティバックアップを復元します。

構文

Restore-SPEnterpriseSearchServiceApplication
       [-Name] <String>
       -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
       -AdminSearchServiceInstance <SearchServiceInstancePipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       -DatabaseName <String>
       [-DatabasePassword <SecureString>]
       -DatabaseServer <String>
       [-DatabaseUsername <String>]
       [-FailoverDatabaseServer <String>]
       [-WhatIf]
       [<CommonParameters>]

Restore-SPEnterpriseSearchServiceApplication
       [-Name] <String>
       -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-KeepId]
       [-WhatIf]
       -TopologyFile <String>
       [-DeferUpgradeActions]
       [<CommonParameters>]

説明

このコマンドレットには、複数のパラメーターセットが含まれています。

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

このコマンドレットでは、サードパーティが既存のデータを使った検索アプリケーションを作成できます。

一部のサードパーティでは、アプリケーションのデータをバックアップし、後でアプリケーションを復元する場合があります。そのため、データが復元され、コマンドレットを Restore-SPEnterpriseSearchServiceApplication 使用して、復元されたデータを使用する新しい検索アプリケーションが作成されます。

このコマンドレットは、パラメーターセットをサポートします。

1 つ目のパラメーターセットは Application Configuration Attach (アプリケーション構成のアタッチ) モードで、2 つ目のパラメーターセットは Search Application Attach (検索アプリケーションのアタッチ) モードです。

Application Configuration Attach モードでは、管理データベース内の構成データのみが復元されます。これに対し、Search Application Attach モードでは、構成、トポロジ、およびすべてのクロールデータが復元されます。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンラインドキュメントをご覧ください。

例

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

$searchInstance = Get-SPEnterpriseSearchServiceInstance -local
$applicationPool = New-SPServiceApplicationPool -Name "SearchServiceApplicationPool" -Account "domain\username"
Restore-SPEnterpriseSearchServiceApplication -Name "SearchServiceApplication" -ApplicationPool $applicationPool -AdminSearchServiceInstance $searchInstance -DatabaseName "SearchServiceApplication_Admindb" -DatabaseServer "SQLServer1"

この例では、Application Configuration Attach モードを使用して構成データを復元します。

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

$applicationPool = New-SPServiceApplicationPool -Name "SearchServiceApplicationPool" -Account "domain\username"
Restore-SPEnterpriseSearchServiceApplication -Name "SearchServiceApplication" -ApplicationPool $applicationPool -TopologyFile "C:\TopologyFile.xml"

この例では、Search Application Attach モードを使用してファイル topology.xml 内のトポロジデータを復元します。

パラメーター

-AdminSearchServiceInstance

管理コンポーネントで使用する検索サービスインスタンスを指定します。

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

-ApplicationPool

クエリ Web サービスのアプリケーションプールを指定します。

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

-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

-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

-DatabaseName

検索アプリケーションの復元用に作成するデータベースの名前を指定します。

型は、SQL Server データベースの有効な名前である必要があります (RestoreDB1 など)。

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

-DatabasePassword

SQL Server上のデータベースサーバーのパスワードの名前を指定します。

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

-DatabaseServer

DatabaseName で指定したデータベースのホストサーバーの名前を指定します。

型は、SQLServerHost1 など、有効なSQL Serverホスト名である必要があります。

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

-DatabaseUsername

Database Server パラメーターで指定したサーバーのアカウント名を指定します。

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

-DeferUpgradeActions

復元中のデータベーススキーマの更新を防止します。使用しないでください。

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

-FailoverDatabaseServer

管理データベースにフェールオーバーデータベースサーバーを使用する場合は、このパラメーターを使用します。

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

-KeepId

復元された検索サービスアプリケーションに、トポロジ.xmlファイルからの検索サービスアプリケーション ID を使用するかどうかを指定します。

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

-Name

新しい検索アプリケーションの名前を指定します。

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

-TopologyFile

アプリケーショントポロジ情報を格納する XML ファイルのパスを指定します。

Type:	String
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

次の方法で共有