Disable-SPFeature

Ссылка

Модуль:: sharepoint-server

Применяется к:: SharePoint Server Subscription Edition

Отключает установленный компонент SharePoint в заданной области действия.

Синтаксис

Disable-SPFeature
       [-Identity] <SPFeatureDefinitionPipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-Url <String>]
       [-WhatIf]
       [<CommonParameters>]

Описание

Командлет Disable-SPFeature отключает компонент SharePoint в заданной области. Если областью действия компонента является ферма, URL-адрес указывать не нужно. В противном случае необходимо указать URL-адрес отключаемого компонента (явно указывать область действия не требуется).

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

Примеры

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

Disable-SPFeature -identity "MyCustom" -URL https://somesite

В этом примере отключается функция "MyCustom" с областью действия веб-сайта по адресу https://somesite.

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

$w = Get-SPWeb https://somesite/myweb | ForEach{ $_.URL }
Get-SPFeature -Web $w | ForEach-Object { Disable-SPFeature -Identity $_ -URL $w}

В этом примере отключается все функции дочернего сайта по адресу https://somesite/myweb.

В этом случае вам не нужно использовать командлеты SPAssignment, так как веб-объект не хранится — только строковое значение URL-адреса.

Параметры

-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 Subscription Edition

-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 Subscription Edition

-Force

Принудительно отключает компонент.

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

-Identity

Задает имя или идентификатор GUID отключаемого компонента.

Тип должен быть именем папки Feature, расположенной в папке "$env:ProgramFiles\Common Files\Майкрософт Shared\Web Server Extensions[14|15|16]\Template\Features" или GUID в формате 21d186e1-7036-4092-a825-0eb6709e9999999999281.

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

-Url

Задает URL-адрес веб-приложения, семейства веб-сайтов или веб-сайта, для которого отключается компонент.

Тип должен быть допустимым URL-адресом, например https://server_name.

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

-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 Subscription Edition

Бөлісу құралы: