Compartilhar via


Get-SPFeature

Devolve as Funcionalidades do SharePoint com base num determinado âmbito.

Sintaxe

FarmFeatures

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

SiteFeatures

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

WebFeatures

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

WebApplicationFeatures

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

FarmFeatureDefinitions

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 utilizar conjuntos de parâmetros, veja Conjuntos https://go.microsoft.com/fwlink/?LinkID=18781de Parâmetros do 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 recentes sobre Windows PowerShell para Produtos 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 devolve o nome e o identificador (ID) de cada Funcionalidade ativada exclusivamente em cada objeto SPWeb na coleção de sites em https://somesite.

Parâmetros

-AssignmentCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CompatibilityLevel

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FarmFeatureDefinitions
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Farm

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FarmFeatures
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome do Recurso a ser recuperado.

O tipo tem de ser o nome completo ou parcial, no formulário Funcionalidade1 ou GUID, no formato 1234-4567-9879, da Funcionalidade a obter.

Propriedades do parâmetro

Tipo:SPFeatureDefinitionPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Limit

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Sandboxed

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica para obter as funcionalidades do Sandbox.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SiteFeatures
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Site

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPSitePipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SiteFeatures
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Web

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPWebPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

WebFeatures
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WebApplication

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPWebApplicationPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

WebApplicationFeatures
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.