Install-SPFeature

Referência

Módulo:: SharePointServer

Aplica-se a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Instala um Recurso do SharePoint usando o arquivo Feature.xml.

Syntax

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

Description

Este cmdlet contém mais de um conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

O Install-SPFeature cmdlet instala um SPFeature específico fornecendo, no parâmetro Identity, o caminho relativo da pasta FEATURES comum específica da versão para o recurso. The version-specific FEATURES folder is "$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES" if the site collection is in 14 mode, and "$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES" if the site collection is in 15 mode. Os SharePoint arquivos do Recurso já devem ser colocados no diretório apropriado, manualmente ou usando um instalador de solução.

Se o valor do parâmetro AllExistingFeatures for verdadeiro, o sistema de arquivos será verificado e todos os novos recursos que estão em ambas as pastas FEATURES serão instalados. Isso geralmente é usado somente durante a implantação e atualização.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

--------------EXEMPLO 1-----------------

Install-SPFeature -path "MyCustomFeature"

Este exemplo instala um novo recurso em $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature/feature.xml.

--------------EXEMPLO 2-----------------

Install-SPFeature -AllExistingFeatures -Whatif

Este exemplo mostra os recursos não registrados, disponíveis no sistema de arquivos, que serão instalados se esse comando for executado sem o parâmetro WhatIf. Isso é geralmente feito após um processo de atualização.

--------------EXEMPLO 3-----------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 14

Este exemplo instala um novo recurso em $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

--------------EXEMPLO 4-----------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 15

Este exemplo instala um novo recurso em $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

Parâmetros

-AllExistingFeatures

Verifica se há recursos existentes, mas não registrados, e registra-os com o farm.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AssignmentCollection

Gerencia objetos para fins de descarte adequado. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CompatibilityLevel

Especifica a versão do recurso a instalar. Quando a versão não é especificada, será padrão para o valor MaxVersion dos aplicativos Web.

Os valores para isso podem ser 14 ou 15.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Solicita a sua confirmação antes de executar o comando. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Força

Impõe a instalação de um recurso já instalado.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Path

Especifica um caminho de arquivo autêntico; por exemplo, MyFeature.

O caminho para o recurso deve ser um caminho literal para o diretório 14\Template\Features. O nome de arquivo feature.xml está implícito e não precisa ser fornecido.

Se o caminho para o recurso não for encontrado, a seguinte mensagem de erro será exibida: "Falha ao localizar o arquivo XML no local 14\Template\Features \ <file path> ."

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ScanForFeatures

Examina e exibe um recurso. O parâmetro ScanForFeatures não instala um recurso.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SolutionId

Especifica a ID da solução dos recursos. Caso o parâmetro SolutionId não seja fornecido, todas as IDs de solução serão examinadas.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019