Поделиться через


New-SPEnterpriseSearchSecurityTrimmer

Добавляет в общее приложение поиска пользовательский триммер безопасности.

Синтаксис

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

Описание

Этот командлет создает новый объект для настройки триммера безопасности. Объект SPEnterpriseSearchSecurityTrimmer представляет триммер безопасности, фильтрующий результаты поиска по ролям безопасности в ходе выполнения запроса при возвращении результатов пользователю.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

------------------ПРИМЕР------------------

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

В этом примере добавляется новый пользовательский триммер безопасности для фильтрации возвращаемого результирующего набора. Этот новый триммер безопасности добавляется в приложение поиска с идентификатором 1. Сборка со строгим именем содержит класс CustomSecurityTrimmerPost, который реализует интерфейс ISecurityTrimmerPost.

Параметры

-AssignmentCollection

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Id

Задает идентификатор триммера безопасности для указанного приложения поиска.

Если данный параметр задает существующий пользовательский триммер безопасности, триммер удаляется и заменяется пользовательским триммером.

Перед добавлением нового триммера необходимо удалить существующий.

Type:Int32
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Properties

Задает пары имени и значения, задающие конфигурационные свойства.

Возможные значения: список имен и значений в следующем формате: Имя1~Значение1~Имя2~Значение2~

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RulePath

Задает путь к контенту, к которому требуется применить триммер безопасности.

Возможные значения этой строки: допустимый URI в формате file:\\имя_сервера\контент, соответствующий используемому правилу обхода.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SearchApplication

Добавляет триммер безопасности в указанное приложение поиска.

Возможные значения: допустимый идентификатор GUID в формате 12345678-90ab-cdef-1234-567890bcdefgh, допустимое имя приложения поиска (например, SearchApp1) или экземпляр допустимого объекта SearchServiceApplication.

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-TypeName

Задает строго именованное имя сборки типа триммера безопасности. Строгое имя должно относиться к типу, сборка которого развертывается в глобальном кэше сборок на сервере запросов, и этот тип должен реализовывать интерфейс ISecurityTrimmerPre, ISecurityTrimmerPost или ISecurityTrimmer2. Обрезку безопасности можно выполнить в двух местах: до выполнения запроса (ISecurityTrimmerPre) или после возврата набора результатов (ISecurityTrimmerPost или ISecurityTrimmer2). Сведения о том, как ссылаться на сборку строгих имен, см. в разделе 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019