New-SPEnterpriseSearchSecurityTrimmer
共有検索アプリケーションにカスタム セキュリティ トリマーを追加します。
構文
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 Subscription Edition |
-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 Subscription Edition |
-Id
指定した検索アプリケーションで使用するセキュリティ トリマーの ID を指定します。
このパラメーターで既存のカスタム セキュリティ トリマーを指定すると、そのトリマーが削除されて、カスタム トリマーに置き換えられます。
新しいトリマーを追加する前に既存のトリマーを削除してください。
| Type: | Int32 |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-RulePath
セキュリティ トリマーの適用先のコンテンツ パスを指定します。
この文字列は、"file:\\サーバー名\コンテンツ" という形式の有効な URI であることが必要です。また、既存のクロール ルールと対応している必要があります。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |