Install-SPFeature

Ссылка

Модуль:: sharepoint-server

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

Устанавливает компонент SharePoint с помощью файла Feature.xml.

Синтаксис

Install-SPFeature
       [-Path] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-CompatibilityLevel <Int32>]
       [-Confirm]
       [-Force]
       [-WhatIf]
       [<CommonParameters>]

Install-SPFeature
       [-AllExistingFeatures]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-SolutionId <String>]
       [-WhatIf]
       [<CommonParameters>]

Install-SPFeature
       [-ScanForFeatures]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-SolutionId <String>]
       [-WhatIf]
       [<CommonParameters>]

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров; использование параметров из разных наборов не допускается. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

Командлет Install-SPFeature устанавливает определенную spFeature, предоставляя в параметре Identity относительный путь из папки common FEATURES для конкретной версии к компоненту. Папка FEATURES для конкретной версии — "$env:ProgramFiles\Common Files\Майкрософт Shared\Web Server Extensions\14\TEMPLATE\FEATURES", если семейство веб-сайтов находится в режиме 14, и "$env:ProgramFiles\Common Files\Майкрософт Shared\Web Server Extensions\15\TEMPLATE\FEATURES", если семейство веб-сайтов находится в режиме 15. Файлы компонента SharePoint уже должны быть помещены в правильный каталог вручную или с помощью установщика решения.

Если параметру AllExistingFeatures присвоено значение true, выполняется сканирование файловой системы и установка всех новых компонентов, которые присутствуют одновременно в обеих папках FEATURES. Подобные сценарии используются в основном во время развертывания или обновления.

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

Примеры

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

Install-SPFeature -path "MyCustomFeature"

В этом примере устанавливается новый компонент по адресу $env:ProgramFiles\Common Files\Майкрософт Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature/feature.xml.

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

Install-SPFeature -AllExistingFeatures -Whatif

В этом примере показаны незарегистрированные компоненты, доступные в файловой системе и устанавливаемые, если эта команда выполняется без параметра WhatIf. Данный сценарий обычно применяется после процесса обновления.

--------------ПРИМЕР 3-----------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 14

В этом примере устанавливается новый компонент на $env:ProgramFiles\Common Files\Майкрософт Shared\Web Server Extensions\14\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

--------------------------ПРИМЕР 4------------------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 15

В этом примере устанавливается новый компонент $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

Параметры

-AllExistingFeatures

Осуществляет сканирование на предмет существующих, но незарегистрированных компонентов, и затем регистрирует их в ферме.

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

-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

Задет версию компонента, которую требуется установить. Если версия не указана, по умолчанию используется значение MaxVersion для веб-приложений.

Для этого могут быть значения 14 или 15.

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

Предписывает принудительную установку уже установленного компонента.

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

-Path

Задает подлинный путь к файлу, например, MyFeature.

Путь к компоненту должен представлять собой путь к каталогу 14\Template\Features, заданный в виде литерала. Имя файла feature.xml подразумевается, и его указывать не следует.

Если путь к компоненту не найден, отображается следующее сообщение об ошибке: "Не удалось найти XML-файл в расположении 14\Template\Features\<file path>".

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

-ScanForFeatures

Предписывает выполнение сканирования и отображение компонента. Параметр ScanForFeatures не предусматривает установку компонента.

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

-SolutionId

Задает идентификатор решения для компонентов. Если параметр SolutionId не указан, сканируются все идентификаторы решений.

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