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


Enable-SPFeature

Включает установленные компоненты 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-----------------

C:\PS>$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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CompatibilityLevel

{{Fill CompatibilityLevel Description}}

Type:Int32
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

-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

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-PassThru

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

Type:SwitchParameter
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

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