New-SPEnterpriseSearchQueryScopeRule

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

共有された範囲ルールをクエリの範囲に追加します。

構文

New-SPEnterpriseSearchQueryScopeRule
   -RuleType <String>
   -Scope <ScopePipeBind>
   -Url <Uri>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-FilterBehavior <String>]
   [-ManagedProperty <ManagedPropertyPipeBind>]
   [-MatchingString <String>]
   [-PropertyValue <String>]
   [-SearchApplication <SearchServiceApplicationPipeBind>]
   [-UrlScopeRuleType <String>]
   [-WhatIf]
   [<CommonParameters>]

説明

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

コマンドレットは New-SPEnterpriseSearchQueryScopeRule 、新しい共有スコープ ルールを作成します。 SPEnterpriseSearchQueryScopeRule は、範囲に適用できるクエリ結果の範囲ルールを表します。

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

例

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

C:\PS>$ssa = Get-SPEnterpriseSearchServiceApplication
C:\PS>$scope = Get-SPEnterpriseSearchQueryScope -Identity MustCrawl -SearchApplication $ssa
New-SPEnterpriseSearchQueryScopeRule -Scope $scope -RuleType AllContent -Url https://criticalSite

この例では、URL の AllContent 型の新しいスコープ ルールを作成します https://criticalSite.

パラメーター

-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

-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

-FilterBehavior

クエリ範囲に対して作成する範囲ルールの種類を指定します。 既定値は Include です。

この型は、Exclude、Include、Require のいずれかの値であることが必要です。

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

-ManagedProperty

PropertyQuery 範囲ルールに使用する管理プロパティを指定します。

この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、管理プロパティの有効な名前 (ManagedProperty1 など) であるか、有効な ManagedProperty オブジェクト インスタンスであることが必要です。

Type:ManagedPropertyPipeBind
Aliases:mname
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

-MatchingString

URL ルールの種類を照合するための文字列を指定します。

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

-PropertyValue

PropertyQuery ルールの種類を照合するためのプロパティの値を指定します。

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

-RuleType

作成する範囲ルールの種類を指定します。

この型は、AllContent、Url、PropertyQuery のいずれかの値であることが必要です。

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

-Scope

指定した範囲にクエリ範囲ルールを適用します。

この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、範囲の有効な名前 (Scope1 など) であるか、有効な Scope オブジェクト インスタンスであることが必要です。

Type:ScopePipeBind
Aliases:s
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

-SearchApplication

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

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

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

-Url

クエリ範囲ルールに関連付けられている結果 URL を指定します。

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

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

-UrlScopeRuleType

URL ルールの種類を照合するための値を指定します。

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

-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