[アーティクル]
10/17/2016

New-SPEnterpriseSearchQueryComponent

適用先: SharePoint Server 2010

トピックの最終更新日: 2015-03-09

クエリトポロジにクエリコンポーネントを追加します。

Syntax

New-SPEnterpriseSearchQueryComponent -IndexPartition <IndexPartitionPipeBind> -QueryTopology <QueryTopologyPipeBind> -SearchServiceInstance <SearchServiceInstancePipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-FailoverOnly <SwitchParameter>] [-IndexLocation <String>] [-SearchApplication <SearchServiceApplicationPipeBind>] [-ShareName <String>] [-WhatIf [<SwitchParameter>]]

詳細説明

New-SPEnterpriseSearchQueryComponent コマンドレットは、検索機能を初期構成するときや、新しいクエリコンポーネントを共有検索アプリケーションに追加するときに使用します。クエリトポロジには、1 つ以上のインデックスパーティションやクエリコンポーネントを格納します。クエリコンポーネントは、ユーザークエリで生成したフルテキスト用語検索をインデックスパーティション内で実行します。

権限の詳細と、検索コマンドレットの最新情報については、https://go.microsoft.com/fwlink/?LinkId=163185 にあるドキュメントを参照してください。

Parameters

パラメーター	必須/省略可	型	説明
IndexPartition	必須	Microsoft.Office.Server.Search.Cmdlet.IndexPartitionPipeBind	クエリコンポーネントに使用するインデックスパーティションを指定します。この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、有効な IndexPartition オブジェクトインスタンスであることが必要です。
QueryTopology	必須	Microsoft.Office.Server.Search.Cmdlet.QueryTopologyPipeBind	クエリコンポーネントコレクションを含むクエリトポロジを指定します。この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、有効な QueryTopology オブジェクトインスタンスであることが必要です。
SearchServiceInstance	必須	Microsoft.Office.Server.Search.Cmdlet.SearchServiceInstancePipeBind	新しいクエリコンポーネントをホストする検索サービスインスタンスを指定します。この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、クエリサーバーの有効な名前 (MyQueryServer など) であるか、有効な SearchServiceInstance オブジェクトインスタンスであることが必要です。
AssignmentCollection	省略可	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	適切な破棄を行うためにオブジェクトを管理します。SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。注意 Global パラメーターが使用されている場合は、オブジェクトはすべてグローバルストアに格納されます。Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
Confirm	省略可	System.Management.Automation.SwitchParameter	コマンドを実行する前に、確認のメッセージを表示します。詳細を表示するには、「get-help about_commonparameters」と入力します。
FailoverOnly	省略可	System.Management.Automation.SwitchParameter	クエリコンポーネントをフェールオーバーに使用するかどうかを指定します。
IndexLocation	省略可	System.String	フルテキストインデックスファイルを作成するインデックスディレクトリへのパスを指定します。この型は、次のいずれかの形式の有効なパスであることが必要です。 - C:\<フォルダー名> - \\<サーバー名>\<フォルダー名>
SearchApplication	省略可	Microsoft.Office.Server.Search.Cmdlet.SearchServiceApplicationPipeBind	クエリトポロジを含む検索アプリケーションを指定します。この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、検索アプリケーションの有効な名前 (SearchApp1 など) であるか、有効な SearchServiceApplication オブジェクトインスタンスであることが必要です。
ShareName	省略可	System.String	IndexLocation で指定したパスにあるファイル共有の名前を指定します。この文字列は、UNC パスに使用できる有効な文字のみで構成する必要があります。この型は、ファイル共有の有効な名前 (FileShare1 など) であることが必要です。
WhatIf	省略可	System.Management.Automation.SwitchParameter	コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。詳細を表示するには、「get-help about_commonparameters」と入力します。

入力値の型

戻り値の型

Example

------------------ 例 ------------------

$ssa = GetSPEnterpriseSearchServiceApplication
$qtOld = $ssa | Get-SPEnterpriseSearchQueryTopology -Active
$ssInstance = Get-SPEnterpriseSearchServiceInstance -Local
$qtNew = $ssa | New-SPEnterpriseSearchQueryTopology -Partitions 1 
$idxPartition = (Get-SPEnterpriseSearchIndexPartition -QueryTopology $qtOld)
$queryComponent = New-SPEnterpriseSearchQuerycomponent -QueryTopology $qtNew -IndexPartition $idxPartition -SearchServiceInstance $ssInstance
$qtNew | Set-SPEnterpriseSearchQueryTopology -Active
$qtOld | Remove-SPEnterpriseSearchQueryTopology

この例では、単一のパーティションを持つクエリトポロジを作成し、そのトポロジのクエリコンポーネントを作成します。次に、新しく作成したクエリトポロジを検索アプリケーション MySSA のアクティブなクエリトポロジとして設定し、古いトポロジを削除します。

次の方法で共有