New-SPEnterpriseSearchSecurityTrimmer

  • Riferimento
Modulo:
sharepoint-server
Si applica a:
SharePoint Server Subscription Edition

Aggiunge un trimmer di sicurezza personalizzato a un'applicazione di ricerca condivisa.

Sintassi

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

Descrizione

Questo cmdlet crea un nuovo oggetto per la configurazione del trimmer di sicurezza. SPEnterpriseSearchSecurityTrimmer rappresenta un trimmer di sicurezza che durante una query applica limitazioni personalizzate per motivi di sicurezza ai risultati di ricerca, quando i risultati sono restituiti all'utente.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO------------------

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

In questo esempio viene aggiunto un nuovo trimmer di sicurezza personalizzato per la pulizia del set di risultati restituito. Questo nuovo trimmer di sicurezza viene aggiunto all'applicazione di ricerca con l'ID 1. L'assembly con nome sicuro include la classe CustomSecurityTrimmerPost, che implementa l'interfaccia ISecurityTrimmerPost.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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

Specifica l'identità del trimmer di sicurezza da utilizzare per l'applicazione di ricerca specificata.

Se questo parametro specifica un trimmer di sicurezza personalizzato esistente, il trimmer verrà rimosso e sostituito dal trimmer personalizzato.

Rimuovere il trimmer esistente prima di aggiungerne uno nuovo.

Type:Int32
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Properties

Specifica il nome-valore che specificano le proprietà di configurazione.

Il tipo deve avere il seguente formato: nome1~valore1~nome2~valore2~

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-RulePath

Specifica il percorso del contenuto in cui il trimmer di sicurezza verrà applicato.

La stringa deve essere un URI valido nel formato file:\\nome_server\contenuto e deve corrispondere a una regola di ricerca per indicizzazione esistente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SearchApplication

Aggiunge il trimmer di sicurezza all'applicazione di ricerca specificata.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome di applicazione di ricerca valido (ad esempio AppRicerca1) oppure un'istanza di un oggetto SearchServiceApplication valido.

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-TypeName

Specifica il nome dell'assembly con nome sicuro di un tipo di trimmer di sicurezza. Il nome sicuro deve fare riferimento a un tipo il cui assembly viene distribuito nella Global Assembly Cache in un server di query e tale tipo deve implementare l'interfaccia ISecurityTrimmerPre, ISecurityTrimmerPost o ISecurityTrimmer2. La limitazione per motivi di sicurezza può essere applicata in due momenti: prima dell'esecuzione della query (ISecurityTrimmerPre) e/o dopo la restituzione del set di risultati (ISecurityTrimmerPost o ISecurityTrimmer2). Per informazioni su come fare riferimento a un assembly con nome sicuro, vedere 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

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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