Set-SPEnterpriseSearchQueryScopeRule

クエリ範囲の共有範囲ルールのプロパティを設定します。

構文

Set-SPEnterpriseSearchQueryScopeRule
   [-Identity] <ScopeRulePipeBind>
   -Url <Uri>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-FilterBehavior <String>]
   [-ManagedPropertyName <String>]
   [-MatchingString <String>]
   [-PropertyValue <String>]
   [-Scope <ScopePipeBind>]
   [-SearchApplication <SearchServiceApplicationPipeBind>]
   [-UrlScopeRuleType <String>]
   [-WhatIf]
   [<CommonParameters>]

説明

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

コマンドレットは Set-SPEnterpriseSearchQueryScopeRule 、クエリ スコープのプロパティを更新します。 SPEnterpriseSearchQueryScopeRule は、範囲に適用できるクエリ結果の範囲ルールを表します。

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

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

$ssa = Get-SPEnterpriseSearchServiceApplication
$scope = Get-SPEnterpriseSearchQueryScope -Identity MustCrawl -SearchApplication $ssa
Get-SPEnterpriseSearchQueryScopeRule -Scope $scope -Url https://criticalSite | Set-SPEnterpriseSearchQueryScopeRule -Url https://criticalSite -UrlScopeRuleType Url

この例では、URL https://criticalSite のスコープ 規則への参照を取得し、その規則の種類を Url に設定します。

パラメーター

-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

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

この型は、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

-Identity

更新する範囲ルールを指定します。

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

Type:ScopeRulePipeBind
Position:1
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

-ManagedPropertyName

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

この型は、有効な管理プロパティ名 (ManagedProp1 など) であることが必要です。

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

-Scope

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

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

Type:ScopePipeBind
Aliases:n
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: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 ルールの種類を照合するための値を指定します。

この型は、Folder、HostName、Domain のいずれかの値であることが必要です。

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