Enable-SPFeature

Ссылка

Модуль:: sharepoint-server

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

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

Синтаксис

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

Enable-SPFeature
      [-Identity] <SPFeatureDefinitionPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Force]
      [-PassThru]
      [-WhatIf]
      [-CompatibilityLevel <Int32>]
      [<CommonParameters>]

Описание

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

Этот командлет не возвращает никаких результатов за исключением случаев, когда задан параметр PassThru. В подобных случаях для нового включенного компонента возвращается объект SPFeatureDefinition.

При попытке использовать параметр Url для компонента с областью действия в пределах фермы на экран будет выведено следующее сообщение об ошибке:

Функция "<имя> компонента" применяется ко всей ферме. Параметр URL-адреса нельзя использовать с функциями на уровне фермы.

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

Примеры

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

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

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

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

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

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

Параметры

-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

-CompatibilityLevel

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

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

Примечание.

Обратите внимание, что -Force не будет работать, если вы обновили эту функцию с помощью Update-SPSolution. В этом случае необходимо сначала отключить функцию с Disable-SPFeature , а затем снова включить ее с помощью Enable-SPFeature

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.

Тип должен быть именем папки компонента, расположенного в папке 14\Template\Features, или идентификатором GUID в формате 21d186e1-7036-4092-a825-0eb6709e9281.

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

-PassThru

Если этот параметр задан, командлет выводит объект определения компонента после включения.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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