Get-SPFeature

Modulo:

sharepoint-server

Si applica a:

SharePoint Server Subscription Edition

Restituisce le funzionalità di SharePoint in base a un determinato ambito.

Sintassi

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

Descrizione

Questo cmdlet include più set di parametri.

È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Cmdlet Parameter Sets https://go.microsoft.com/fwlink/?LinkID=18781.

Tutti i set di parametri accettano il parametro Identity, che può essere il percorso relativo della caratteristica di SharePoint (considerato il nome della caratteristica) oppure il GUID di una definizione di caratteristica.

Se si specifica il parametro Identity, i cmdlet tenteranno di trovare l'istanza o la definizione di caratteristica specificata per l'ambito specificato. Se non si specificano parametri, verranno restituite tutte le caratteristiche installate.

Il comportamento del cmdlet Get-SPFeature varia in base all'ambito e restituisce le caratteristiche attivate a ogni livello. Se non si specifica un ambito, verranno restituite tutte le caratteristiche installate.

Per le autorizzazioni e le informazioni più aggiornate sulle Windows PowerShell per i prodotti SharePoint, vedere la documentazione online all'indirizzo https://go.microsoft.com/fwlink/p/?LinkId=251831.

Esempio

--------------ESEMPIO 1-----------------

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

Questo esempio consente di restituire un elenco di tutte le caratteristiche installate con ambito SITE.

--------------ESEMPIO 2-----------------

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

Questo esempio restituisce il nome e l'identificatore (ID) di ogni funzionalità abilitata in modo univoco in ogni oggetto SPWeb nella raccolta siti all'indirizzo https://somesite.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

-CompatibilityLevel

Specifica la versione dei modelli da utilizzare durante la creazione di un nuovo oggetto SPSite. Questo valore consente di impostare il valore CompatibilityLevel iniziale per la raccolta siti. Se questo parametro non viene specificato, come CompatibilityLevel verrà utilizzata per impostazione predefinita la versione più alta possibile per l'applicazione Web in base all'impostazione 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

Se questo parametro viene utilizzato, specifica che verranno visualizzate solo le caratteristiche attivate della farm.

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

-Identity

Specifica il nome della caratteristica da recuperare.

Il tipo deve essere il nome completo o parziale, nel formato Feature1, o un GUID, nel formato 1234-4567-9879, della funzionalità da ottenere.

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 i risultati visualizzati. Se si specifica "All", verranno visualizzate tutte le caratteristiche.

Il tipo deve essere un numero valido maggiore di 0. Il valore predefinito è 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

Specifica di recuperare le funzionalità 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

Specifica il nome della raccolta siti da cui recuperare le caratteristiche attivate.

Il tipo deve essere un URL valido per una raccolta siti nel 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

Specifica l'URL o il GUID del Web.

Il tipo deve essere un URL valido nel formato https://server_name oppure un GUID nel 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

Specifica il nome dell'applicazione Web da cui recuperare le caratteristiche attivate.

Il tipo deve essere un URL valido dell'applicazione Web nel 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