Remove-SPEnterpriseSearchResultItemType

Удаление типа элемента результата для владельца объекта поиска.

Синтаксис

Default (по умолчанию)

Remove-SPEnterpriseSearchResultItemType
    [-Identity] <ResultItemTypePipeBind>
    -Owner <SearchObjectOwner>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-SearchApplication <SearchServiceApplicationPipeBind>]
    [-SearchApplicationProxy <SearchServiceApplicationProxyPipeBind>]
    [-WhatIf]
    [<CommonParameters>]

Описание

Командлет Remove-SPEnterpriseSearchResultItemType удаляет созданный пользователем тип элемента результата с учетом идентификатора типа результата и владельца поиска. Этот командлет нельзя использовать для удаления встроенных типов элементов результатов, включенных в продукты SharePoint.

Типы элементов результатов позволяют изменить вид результатов поиска в зависимости от типа результата. Сначала вы определяете набор правил, которые будут оцениваться относительно свойств результатов. Затем вы определяете шаблон отображения, который будет использоваться для воспроизведения результатов такого типа. После того как вы создадите тип элемента результата, соответствующие правилам результаты будут отображаться с использованием заданного шаблона отображения.

Примеры использования:

  • Измените внешний вид результатов для определенного расширения имени файла, например Word документов.

  • изменение вида определенного типа контента в результатах поиска;

  • изменение вида результатов от конкретного автора;

  • добавление действия с результатом в результаты из конкретного источника в качестве части пользовательского приложения поиска.

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

Примеры

ПРИМЕР

$web = Get-SPWeb "UrlOfTheSite"
$tenantOwner = Get-SPEnterpriseSearchOwner -Level SPSite -SPWeb $web
$searchapp = Get-SPEnterpriseSearchServiceApplication
$resultType = Get-SPEnterpriseSearchResultItemType -Owner $tenantOwner -SearchApplication $searchapp
Remove-SPEnterpriseSearchResultItemType -Identity $resultType -Owner $tenantOwner -SearchApplication $searchapp

В этом примере сначала определяются переменные для URL-адреса сайта, владельца поиска и приложения поиска. Затем извлекается тип элемента результата и проверяется, является ли он встроенным. Если $resultType.BuiltIn возвращает значение false, то тип элемента результата не является встроенным, и вы можете его изменить. Далее в примере удаляется тип элемента результата, определяемый переменной $resultType, для владельца, определяемого переменной $tenantOwner.

Параметры

-AssignmentCollection

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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

Свойства параметра

Тип:SPAssignmentCollection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Свойства параметра

Тип:ResultItemTypePipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Owner

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает владельца объекта поиска, определяющего область, в которой создается тип элемента результата.

Свойства параметра

Тип:SearchObjectOwner
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:o

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SearchApplication

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Свойства параметра

Тип:SearchServiceApplicationPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SearchApplicationProxy

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Свойства параметра

Тип:SearchServiceApplicationProxyPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.