New-SPEnterpriseSearchQueryTopology
適用先: SharePoint Server 2010
トピックの最終更新日: 2015-03-09
共有検索アプリケーションにクエリ トポロジを追加します。
Syntax
New-SPEnterpriseSearchQueryTopology -SearchApplication <SearchServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Clone <SwitchParameter>] [-Clone <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-QueryTopology <QueryTopologyPipeBind>] [-WhatIf [<SwitchParameter>]]
New-SPEnterpriseSearchQueryTopology -SearchApplication <SearchServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Clone <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Partitions <String>] [-WhatIf [<SwitchParameter>]]
詳細説明
New-SPEnterpriseSearchQueryTopology コマンドレットでは、検索機能の初期構成時または新しいクエリ トポロジの作成時に使用します。クエリ コンポーネントやインデックス パーティションをトポロジに追加または削除する場合、検索サービス アプリケーション内に複数のクエリ トポロジがある場合があります。
Parameters
| パラメーター | 必須/省略可 | 型 | 説明 |
|---|---|---|---|
SearchApplication |
必須 |
Microsoft.Office.Server.Search.Cmdlet.SearchServiceApplicationPipeBind |
クエリ トポロジを含む検索アプリケーションを指定します。 この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、検索アプリケーションの有効な名前 (SearchApp1 など) であるか、有効な SearchServiceApplication オブジェクト インスタンスであることが必要です。 |
AssignmentCollection |
省略可 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
適切な破棄を行うためにオブジェクトを管理します。SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。 注意 Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。 |
Clone |
省略可 |
System.Management.Automation.SwitchParameter |
既存のクエリ トポロジを複製して新しいクエリ トポロジを作成するように指定します。 |
Confirm |
省略可 |
System.Management.Automation.SwitchParameter |
コマンドを実行する前に、確認のメッセージを表示します。詳細を表示するには、「get-help about_commonparameters」と入力します。 |
Partitions |
省略可 |
System.String |
新しいクエリ トポロジに使用するクエリ パーティションの数を指定します。 この型は、256 以下の数値を示す有効な文字列であることが必要です。 |
QueryTopology |
省略可 |
Microsoft.Office.Server.Search.Cmdlet.QueryTopologyPipeBind |
新しいクエリ トポロジ用に複製するクエリ トポロジを指定します。 この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、有効な QueryTopology オブジェクト インスタンスであることが必要です。 |
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 のアクティブなクエリ トポロジとして設定し、古いトポロジを削除します。