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-----------------
$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
{{Fill CompatibilityLevel Description}}
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 |