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 |