New-SPEnterpriseSearchSecurityTrimmer
適用先: SharePoint Server 2010
トピックの最終更新日: 2015-03-09
共有検索アプリケーションにカスタム セキュリティ トリマーを追加します。
Syntax
New-SPEnterpriseSearchSecurityTrimmer [-Id] <Int32> -RulePath <String> -SearchApplication <SearchServiceApplicationPipeBind> -TypeName <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Properties <String>] [-WhatIf [<SwitchParameter>]]
詳細説明
New-SPEnterpriseSearchSecurityTrimmer コマンドレットでは、プラグ可能なセキュリティ トリマーを構成するための新しいオブジェクトを作成します。SPEnterpriseSearchSecurityTrimmer は、プラグ可能なセキュリティ トリマーを表し、クエリの検索結果をユーザーに表示するときに独自のセキュリティ トリミングを実行します。
権限の詳細と、検索コマンドレットの最新情報については、https://go.microsoft.com/fwlink/?LinkId=163185 にあるドキュメントを参照してください。
Parameters
| パラメーター | 必須/省略可 | 型 | 説明 |
|---|---|---|---|
Id |
必須 |
System.Int32 |
指定した検索アプリケーションで使用するプラグ可能なセキュリティ トリマーの ID を指定します。このパラメーターで既存のカスタム セキュリティ トリマーを指定すると、そのトリマーが削除されて、カスタム トリマーに置き換えられます。 |
RulePath |
必須 |
System.String |
セキュリティ トリマーの適用先のコンテンツ パスを指定します。 この文字列は、file:\\<サーバー名>\content 形式の有効な URI であることが必要です。また、既存のクロール ルールと対応している必要があります。 |
SearchApplication |
必須 |
Microsoft.Office.Server.Search.Cmdlet.SearchServiceApplicationPipeBind |
指定した検索アプリケーションにセキュリティ トリマーを追加します。 この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、検索アプリケーションの有効な名前 (SearchApp1 など) であるか、有効な SearchServiceApplication オブジェクト インスタンスであることが必要です。 |
TypeName |
必須 |
System.String |
セキュリティ トリマーの型の完全修飾型名を指定します。この名前で参照する型は、そのアセンブリがクエリ サーバーのグローバル アセンブリ キャッシュに配置されていること、および、ISecurityTrimmer インターフェイス (Microsoft.Office.Server.Search.Query.ISecurityTrimmer) が実装されていることが必要です。 |
AssignmentCollection |
省略可 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
適切な破棄を行うためにオブジェクトを管理します。SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。 注意 Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。 |
Confirm |
省略可 |
System.Management.Automation.SwitchParameter |
コマンドを実行する前に、確認のメッセージを表示します。詳細を表示するには、「get-help about_commonparameters」と入力します。 |
Properties |
省略可 |
System.String |
構成プロパティを指定する名前と値のペアを指定します。 この型は、名前と値のペア形式で指定する必要があります (Name1~Value1~Name2~Value2~ など)。 |
WhatIf |
省略可 |
System.Management.Automation.SwitchParameter |
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。詳細を表示するには、「get-help about_commonparameters」と入力します。 |
入力値の型
戻り値の型
Example
------------------ 例 ------------------
$ssa = Get-SPEnterpriseSearchServiceApplication -Identity "MySSA"
New-SPEnterpriseSearchSecurityTrimmer -Id 1234 -SearchApplication $ssa -TypeName Contoso.Security.QueryTrimmer -RulePath http://myServer
この例では、Contoso.Security.QueryTrimmer 型の新しいカスタム セキュリティ トリマーをパス http://myServer に追加します。