New-SPEnterpriseSearchQueryScope

  • リファレンス
モジュール:
SharePointServer
適用対象:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

共有された検索アプリケーションにクエリ結果の範囲を追加します。

構文

New-SPEnterpriseSearchQueryScope
   [-AlternateResultsPage <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompilationType <Int32>]
   [-Confirm]
   -Description <String>
   -DisplayInAdminUI <Boolean>
   [-ExtendedSearchFilter <String>]
   -Name <String>
   [-OwningSiteUrl <Uri>]
   -SearchApplication <SearchServiceApplicationPipeBind>
   [-WhatIf]
   [<CommonParameters>]

説明

Search Service アプリケーションを SharePoint Server にアップグレードした後は、共有スコープを表示できますが、作成、更新、または削除することはできません。 つまり、アップグレード後に共有範囲に対してこのコマンドレットを使用することはできません。 しかし、共有範囲は、同様の結果が得られる検索先に変換できます。 同様に、SharePoint Server サイト コレクションを SharePoint Server モードにアップグレードした後は、ローカル スコープを表示できますが、作成、更新、または削除することはできません。 つまり、サイト コレクションをアップグレードした後で、ローカル範囲にこのコマンドレットを使用することはできません。 しかし、ローカル範囲は、同様の結果が得られる検索先に変換できます。

コマンドレットを New-SPEnterpriseSearchQueryScope 使用して、新しい共有スコープを作成します。 SPEnterpriseSearchQueryScope は、ファームのすべての共有検索アプリケーションで使用するクエリ結果の範囲を表します。

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

例

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

$ssa = Get-SPEnterpriseSearchServiceApplication
New-SPEnterpriseSearchQueryScope -Name MustCrawl -Description "Sites we must crawl" -DisplayInAdminUI $true -SearchApplication $ssa

この例では、管理 UI に表示する範囲 MustCrawl を検索サービス アプリケーション MySSA に追加します。

パラメーター

-AlternateResultsPage

新しいクエリ範囲の結果を表示する場所を指定します。

型は、フォーム内の有効な URL である必要があります https://server_name.

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

-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

-CompilationType

新しい範囲のコンパイルの型を指定します。 値 0 は条件付きでコンパイルされたスコープの種類を指定し、値 1 は常にコンパイルされたスコープの種類を指定します。

この型は、0 または 1 のいずれかであることが必要です。

Type:Int32
Aliases:type
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

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Description

新しいクエリ範囲の説明を追加します。

この型は、有効な文字列であることが必要です。たとえば、「クエリ範囲の説明」などのように指定します。

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

-DisplayInAdminUI

管理アプリケーションのユーザー インターフェイス (UI) に新しい範囲を表示するように指定します。 既定で、管理アプリケーションの UI では新しい範囲が非表示になっています。

Type:Boolean
Aliases:disp
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

-ExtendedSearchFilter

{{Fill ExtendedSearchFilter Description}}

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

-Name

作成する範囲の ID を指定します。

この型は範囲の有効な名前 (Scope1 など) であることが必要です。

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

-OwningSiteUrl

新しい範囲に関連付ける SharePoint サイトを指定します。

型は、フォーム内の有効な SharePoint サイト URL である必要があります https://server_name.

Type:Uri
Aliases:o
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

-SearchApplication

クエリ範囲コレクションを含む検索アプリケーションを指定します。

この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、検索アプリケーションの有効な名前 (SearchApp1 など) であるか、有効な SearchServiceApplication オブジェクトのインスタンスであることが必要です。

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019