New-SPEnterpriseSearchSecurityTrimmer

 

Gilt für: SharePoint Server 2010

Letztes Änderungsdatum des Themas: 2015-03-09

Fügt einer gemeinsam verwendeten Suchanwendung einen benutzerdefinierten Security Trimmer hinzu.

Syntax

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

Detaillierte Beschreibung

Das Cmdlet New-SPEnterpriseSearchSecurityTrimmer erstellt eine neues Objekt, um den Pluggable Security Trimmer zu konfigurieren. SPEnterpriseSearchSecurityTrimmer stellt einen Pluggable Security Trimmer dar, der angepasste Einschränkungen aus Sicherheitsgründen für die Suchergebnisse zur Abfragezeit ausführt, wenn die Ergebnisse an den Benutzer zurückgegeben werden.

Weitere Informationen zu den Berechtigungen sowie aktuelle Informationen zu den Such-Cmdlets finden Sie in der Onlinedokumentation (https://go.microsoft.com/fwlink/?linkid=163185&clcid=0x407).

Parameters

Parameter Erforderlich Typ Beschreibung

Id

Erforderlich

System.Int32

Gibt die Identität des Pluggable Security Trimmers an, der für die angegebene Suchanwendung verwendet werden soll. Wenn dieser Parameter einen vorhandenen benutzerdefinierten Security Trimmer angibt, wird der Trimmer entfernt und durch den benutzerdefinierten Trimmer ersetzt.

RulePath

Erforderlich

System.String

Gibt den Inhaltspfad an, auf den der Security Trimmer angewendet wird.

Die Zeichenfolge muss ein gültiger URI in der Form datei:\\server_name\inhalt sein, und er muss einer vorhandenen Durchforstungsregel entsprechen.

SearchApplication

Erforderlich

Microsoft.Office.Server.Search.Cmdlet.SearchServiceApplicationPipeBind

Fügt den Security Trimmer der angegebenen Suchanwendung hinzu.

Der Typ muss eine gültige GUID in der Form 12345678-90ab-cdef-1234-567890bcdefgh, ein gültiger Name einer Suchanwendung (z. B. SuchAnw1) oder eine Instanz eines gültigen SearchServiceApplication-Objekts sein.

TypeName

Erforderlich

System.String

Gibt den vollqualifizierten Typnamen eines Security Trimmer-Typs an. Der Name muss sich auf einen Typ beziehen, dessen Assembly für den globalen Assemblycache auf einem Abfrageserver bereitgestellt ist, und dieser Typ muss die ISecurityTrimmer-Schnittstelle (Microsoft.Office.Server.Search.Query.ISecurityTrimmer) implementieren.

AssignmentCollection

Optional

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Hinweis

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

Confirm

Optional

System.Management.Automation.SwitchParameter

Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: get-help about_commonparameters

Properties

Optional

System.String

Gibt die Name/Wert-Paare an, die die Konfigurationseigenschaften angeben.

Der Typ muss das folgende Format für das Name/Wert-Paar aufweisen: Name1~Wert1~Name2~Wert2~

WhatIf

Optional

System.Management.Automation.SwitchParameter

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: get-help about_commonparameters

Eingabetypen

Rückgabetypen

Example

--------------------BEISPIEL--------------------

$ssa = Get-SPEnterpriseSearchServiceApplication -Identity "MySSA"
New-SPEnterpriseSearchSecurityTrimmer -Id 1234 -SearchApplication $ssa -TypeName Contoso.Security.QueryTrimmer -RulePath http://myServer

Dieses Beispiel fügt dem Pfad http://myServer einen neuen benutzerdefinierten Security Trimmer des Typs Contoso.Security.QueryTrimmer hinzu.