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 cmdlet 可建立新的物件用於設定可插式安全性修剪器。SPEnterpriseSearchSecurityTrimmer 代表可以在查詢時，針對回傳給使用者之搜尋結果自訂安全性修剪功能的可插式安全性修剪器。
如需搜尋指令程式的權限及最新資訊，請參閱線上文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Id |
必要 |
System.Int32 |
指定給定搜尋應用程式所要使用之可插式安全性修剪器的身分識別。若未指定此參數，將會指定現有的自訂安全性修剪器。若是指定自訂的修剪器，將會移除現有的修剪器，而以自訂的修剪器取代之。 |
RulePath |
必要 |
System.String |
指定要套用安全性修剪器的內容路徑。 此字串必須是格式為 file:\\server_name\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 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
Properties |
選用 |
System.String |
指定成對的名稱與值，以指定設定的屬性。 此類型必須是下列成對的名稱/值格式：名稱 1~ 值 1~ 名稱 2~ 值 2~ |
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。