New-SPEnterpriseSearchSecurityTrimmer

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

共有検索アプリケーションにカスタム セキュリティ トリマーを追加します。

構文

New-SPEnterpriseSearchSecurityTrimmer
   [-Id] <Int32>
   [-RulePath <String>]
   -SearchApplication <SearchServiceApplicationPipeBind>
   -TypeName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Properties <String>]
   [-WhatIf]
   [<CommonParameters>]

説明

このコマンドレットでは、セキュリティ トリマーを構成するための新しいオブジェクトを作成します。 SPEnterpriseSearchSecurityTrimmer は、セキュリティ トリマーを表し、クエリの検索結果をユーザーに表示するときにカスタマイズされたセキュリティによるトリミングを実行します。

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

例

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

$ssa = Get-SPEnterpriseSearchServiceApplication
New-SPEnterpriseSearchSecurityTrimmer -SearchApplication $ssa -TypeName "SearchCustomSecurityTrimmer.CustomSecurityTrimmerPost, SearchCustomSecurityTrimmer, Version=1.0.0.0, Culture=neutral, PublicKeyToken=48e046c834625a88, processorArchitecture=MSIL" -Id 1

この例では、取得する結果セットをトリミングするための新しいカスタム セキュリティ トリマーを追加します。 この新しいセキュリティ トリマーは、ID 1 を使用して検索アプリケーションに追加されます。 厳密な名前のアセンブリには CustomSecurityTrimmerPost クラスが含まれており、このクラスが ISecurityTrimmerPost インターフェイスを実装しています。

パラメーター

-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

-Id

指定した検索アプリケーションで使用するセキュリティ トリマーの ID を指定します。

このパラメーターで既存のカスタム セキュリティ トリマーを指定すると、そのトリマーが削除されて、カスタム トリマーに置き換えられます。

新しいトリマーを追加する前に既存のトリマーを削除してください。

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

-Properties

構成プロパティを指定する名前と値のペアを指定します。

この型は、名前と値のペア形式で指定する必要があります (Name1~Value1~Name2~Value2~ など)。

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

-RulePath

セキュリティ トリマーの適用先のコンテンツ パスを指定します。

この文字列は、"file:\\サーバー名\コンテンツ" という形式の有効な URI であることが必要です。また、既存のクロール ルールと対応している必要があります。

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

-TypeName

セキュリティ トリマーの型の厳密な名前のアセンブリ名を指定します。 厳密な名前は、アセンブリがクエリ サーバー上のグローバル アセンブリ キャッシュに展開される型を参照する必要があり、その型は ISecurityTrimmerPre、ISecurityTrimmerPost、または ISecurityTrimmer2 インターフェイスを実装する必要があります。 セキュリティによるトリミングは、クエリを実行する前 (ISecurityTrimmerPre)、または結果セットが取得された後 (ISecurityTrimmerPost または ISecurityTrimmer2) に行うことができます。 厳密な名前アセンブリを参照する方法については、(https://msdn.microsoft.com/en-us/library/s1sx4kfb.aspx) を参照してくださいhttps://msdn.microsoft.com/en-us/library/s1sx4kfb.aspx。

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

-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