Compartilhar via


New-SPEnterpriseSearchSecurityTrimmer

 

Aplica-se a: SharePoint Server 2010

Tópico modificado em: 2015-03-09

Adiciona um cortador de segurança personalizado a um aplicativo de pesquisa compartilhado.

Syntax

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

Descrição detalhada

O cmdlet New-SPEnterpriseSearchSecurityTrimmer cria um novo objeto para configurar o cortador de segurança conectável. SPEnterpriseSearchSecurityTrimmer representa um cortador de segurança conectável que executa o corte de segurança personalizado de resultados da pesquisa em tempo de consulta, quando os resultados são retornados para o usuário.

Para saber mais sobre permissões e obter as informações mais recentes sobre cmdlets de pesquisa, consulte a documentação online (https://go.microsoft.com/fwlink/?LinkId=163185).

Parameters

Parâmetro Obrigatório Tipo Descrição

Id

Obrigatório

System.Int32

Especifica a identidade do cortador de segurança conectável a ser usado para o aplicativo de pesquisa especificado. Se esse parâmetro especificar um cortador de segurança personalizado existente, o filtro será removido e substituído pelo cortador personalizado.

RulePath

Obrigatório

System.String

Especifica o caminho de conteúdo ao qual o cortador de segurança será aplicado.

A cadeia de caracteres deve ser uma URL válida, no formato file:\\nome_do_servidor\conteúdo, e deve corresponder a uma regra de rastreamento existente.

SearchApplication

Obrigatório

Microsoft.Office.Server.Search.Cmdlet.SearchServiceApplicationPipeBind

Adiciona o cortador de segurança ao aplicativo de pesquisa especificado.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome de aplicativo de pesquisa válido (por exemplo, SearchApp1) ou uma instância de um objeto SearchServiceApplication válido.

TypeName

Obrigatório

System.String

Especifica o nome do tipo totalmente qualificado de um tipo de cortador de segurança. O nome deve se referir a um tipo cujo assembly seja implantado no cache de assembly global em um servidor de consulta, e esse tipo deve implementar a interface ISecurityTrimmer (Microsoft.Office.Server.Search.Query.ISecurityTrimmer).

AssignmentCollection

Opcional

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Gerencia objetos para a finalidade de descarte adequado. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos depois que for necessário liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não é usado.

Observação

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Solicita sua confirmação antes de executar o comando. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Properties

Opcional

System.String

Especifica os pares nome-valor que especificam as propriedades de configuração.

O tipo deve estar no seguinte formato de par nome/valor: Nome1~Valor1~Nome2~Valor2~

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Exibe uma mensagem que descreve o efeito do comando em vez de executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Tipos de entrada

Tipos de retorno

Example

------------------EXEMPLO------------------

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

Este exemplo adiciona um cortador de segurança personalizado do tipo Contoso.Security.QueryTrimmer ao caminho http://myServer.