Enable-SPFeature

  • Riferimento
Modulo:
sharepoint-server
Si applica a:
SharePoint Server Subscription Edition

Attiva una caratteristica di SharePoint installata nell'ambito specificato.

Sintassi

Enable-SPFeature
      [-Identity] <SPFeatureDefinitionPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Force]
      [-PassThru]
      [-Url <String>]
      [-WhatIf]
      [<CommonParameters>]
Enable-SPFeature
      [-Identity] <SPFeatureDefinitionPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Force]
      [-PassThru]
      [-WhatIf]
      [-CompatibilityLevel <Int32>]
      [<CommonParameters>]

Descrizione

Il cmdlet Enable-SPFeature attiva una caratteristica installata nell'ambito specificato. Per una caratteristica della farm non è necessario specificare un URL. In caso contrario, specificare l'URL della posizione in cui deve essere attivata la caratteristica, che verrà attivata nell'ambito appropriato in base alle definizione della caratteristica.

Questo cmdlet non genera alcun output, a meno che non si specifichi il parametro PassThru. In questo caso verrà restituito l'oggetto SPFeatureDefinition per la caratteristica appena attivata.

Se si tenta di utilizzare il parametro Url per una caratteristica con ambito farm, verrà visualizzato un messaggio di errore simile al seguente:

La funzionalità "<nome> funzionalità" si applica all'intera farm. Il parametro URL non può essere usato con le funzionalità con ambito farm.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

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

Enable-SPFeature -identity "MyCustom" -URL https://somesite

In questo esempio viene abilitata la funzionalità di SharePoint con ambito "MyCustom" del sito all'indirizzo https://somesite.

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

$w = Get-SPWeb https://somesite/myweb | ForEach{ $_.URL }
Get-SPFeature -Web $w |%{ Enable-SPFeature -Identity $_ -URL $w}

Questo esempio abilita tutte le funzionalità di SharePoint nel sito secondario all'indirizzo https://somesite/myweb.

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

{{Fill CompatibilityLevel Description}}

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

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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

Forza l'attivazione di una caratteristica. L'eventuale codice personalizzato associato alla caratteristica verrà eseguito nuovamente.

Nota

Tenere presente che -Force non funzionerà se la funzionalità è stata aggiornata con Update-SPSolution. In questo caso è necessario disabilitare prima la funzionalità con Disable-SPFeature e quindi abilitarla di nuovo con Enable-SPFeature

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 funzionalità o del GUID da disinstallare.

Il tipo deve essere il nome della cartella delle caratteristiche in 14\Template\Features oppure il GUID nel formato 21d186e1-7036-4092-a825-0eb6709e9281.

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

-PassThru

Se specificato, il cmdlet restituisce come output l'oggetto di definizione della caratteristica dopo l'attivazione.

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

-Url

Specifica l'URL dell'applicazione Web, della raccolta siti o del sito Web per cui viene attivata la caratteristica.

Il tipo deve essere un URL valido. Per esempio https://server_name.

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

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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