Condividi tramite

Enable-SPFeature

Modulo:
SharePointServer module

Attiva una caratteristica di SharePoint installata nell'ambito specificato.

Sintassi

SiteFeature 

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

FarmFeatureDefinition 

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

C:\PS>$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

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SPAssignmentCollection
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CompatibilityLevel

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

{{Fill CompatibilityLevel Description}}

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

FarmFeatureDefinition
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SPFeatureDefinitionPipeBind
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PassThru

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Url

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SiteFeature
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.