Get-SPFeature

Referência

Módulo:: sharepoint-server

Aplica-se a:: SharePoint Server Subscription Edition

Retorna os recursos do SharePoint com base em um determinado escopo.

Syntax

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Farm]
   [-Limit <String>]
   [<CommonParameters>]

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Limit <String>]
   [-Site <SPSitePipeBind>]
   [-Sandboxed]
   [<CommonParameters>]

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Limit <String>]
   [-Web <SPWebPipeBind>]
   [<CommonParameters>]

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Limit <String>]
   [-WebApplication <SPWebApplicationPipeBind>]
   [<CommonParameters>]

Get-SPFeature
   [[-Identity] <SPFeatureDefinitionPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Limit <String>]
   [-CompatibilityLevel <Int32>]
   [<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, consulte Conjuntos https://go.microsoft.com/fwlink/?LinkID=18781de Parâmetros cmdlet .

Todos os conjuntos de parâmetros usam o parâmetro Identity, que pode ser o caminho relativo do Recurso do SharePoint (considerado o nome do recurso) ou o GUID de uma definição de Recurso.

Se o parâmetro Identity for fornecido, os cmdlets tentarão localizar a definição de Recurso determinada ou a instância do escopo fornecido. Se nenhum parâmetro for especificado, todos os recursos instalados serão retornados.

O cmdlet Get-SPFeature se comporta de maneira diferente em cada escopo, retornando os Recursos habilitados em cada nível. Se nenhum escopo for fornecido, todos os Recursos instalados serão retornados.

Para obter permissões e as informações mais atuais sobre Windows PowerShell para Produtos do SharePoint, consulte a documentação online em https://go.microsoft.com/fwlink/p/?LinkId=251831.

Exemplos

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

Get-SPFeature -Limit ALL | Where-Object {$_.Scope -eq "SITE"}

Este exemplo retorna uma lista de todos os Recursos com escopo SITE instalados.

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

Get-SPSite https://somesite | Get-SPWeb -Limit ALL |%{ Get-SPFeature -Web $_ } | Select DisplayName,ID -Unique

Este exemplo retorna o nome e o identificador (ID) de cada recurso habilitado exclusivamente em cada objeto SPWeb na coleção de sites em https://somesite.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. 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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-CompatibilityLevel

Especifica a versão dos modelos a serem usados ao criar um novo objeto SPSite. Este valor define o valor CompatibilityLevel inicial para o conjunto de sites. Quando este parâmetro não é especificado, o CompatibilityLevel será o padrão para a versão mais alta possível do aplicativo Web, dependendo da configuração CompatibilityRange.

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

-Farm

Especifica que, se este parâmetro for usado, somente os Recursos de farm habilitados serão exibidos.

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

-Identity

Especifica o nome do Recurso a ser recuperado.

O tipo deve ser o nome completo ou parcial, no formulário Feature1 ou guid, no formulário 1234-4567-9879, do Recurso a ser obtido.

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

-Limit

Limita os resultados de exibição. Se "All" for especificado, todos os Recursos serão exibidos.

O tipo deve ser um número válido maior que 0. O valor padrão é 200.

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

-Sandboxed

Especifica para recuperar recursos do Sandbox.

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

-Site

Especifica o nome do conjunto de sites a partir do qual obter os Recursos habilitados.

O tipo deve ser uma URL válida para um conjunto de sites, no formato https://server_name.

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

-Web

Especifica a URL ou o GUID da Web.

O tipo deve ser uma URL válida, no formato https://server_name; ou um GUID, no formato 1234-5678-9876-0987.

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

-WebApplication

Especifica o nome do aplicativo Web a partir do qual obter os Recursos habilitados.

O tipo deve ser uma URL válida, para o aplicativo Web no formato https://server_name.

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