Install-SPFeature

Installa una caratteristica di SharePoint utilizzando il file Feature.xml.

Sintassi

Install-SPFeature
       [-Path] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-CompatibilityLevel <Int32>]
       [-Confirm]
       [-Force]
       [-WhatIf]
       [<CommonParameters>]
Install-SPFeature
       [-AllExistingFeatures]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-SolutionId <String>]
       [-WhatIf]
       [<CommonParameters>]
Install-SPFeature
       [-ScanForFeatures]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-SolutionId <String>]
       [-WhatIf]
       [<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 Set di parametri del cmdlet.

Il cmdlet Install-SPFeature installa un determinato oggetto SPFeature specificando nel parametro Identity il percorso relativo dalla cartella FEATURES comune specifica della versione alla caratteristica. La cartella FEATURES specifica della versione è "$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES" se la raccolta siti è in modalità 14 e "$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES" se la raccolta siti è in modalità 15. I file della caratteristica di SharePoint devono essere già stati inseriti nella directory appropriata, manualmente o tramite un programma di installazione di soluzioni.

Se il valore del parametro AllExistingFeatures è true, verrà eseguita una ricerca nel file system e verranno installate tutte le nuove caratteristiche contenute in entrambe le cartelle FEATURES. Questa opzione in genere viene utilizzata solo durante operazioni di distribuzione e aggiornamento.

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

Install-SPFeature -path "MyCustomFeature"

In questo esempio viene installata una nuova funzionalità in $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature/feature.xml.

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

Install-SPFeature -AllExistingFeatures -Whatif

In questo esempio vengono mostrate le caratteristiche non registrate disponibili nel file system che vengono installate se si esegue il comando senza il parametro WhatIf. Questa operazione viene eseguita in genere dopo un processo di aggiornamento.

--------------ESEMPIO 3-----------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 14

In questo esempio viene installata una nuova funzionalità in $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

--------------ESEMPIO 4-----------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 15

In questo esempio viene installata una nuova caratteristica in env:Programmi\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

Parametri

-AllExistingFeatures

Esegue una ricerca delle caratteristiche esistenti ma non registrate e quindi le registra nella farm.

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

-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 della caratteristica da installare. Se la versione non viene specificata, verrà utilizzato per impostazione predefinita il valore MaxVersion delle applicazioni Web.

I valori per questo valore possono essere 14 o 15.

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

Impone l'installazione di una caratteristica già installata.

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

-Path

Specifica un percorso di file autentico, ad esempio CaratteristicaPersonalizzata.

Il percorso della caratteristica deve essere un percorso letterale della directory 14\Template\Features. Il nome di file feature.xml è implicito e non è necessario specificarlo.

Se il percorso della funzionalità non viene trovato, viene visualizzato il messaggio di errore seguente: "Impossibile trovare il file XML nel percorso 14\Template\Features\<file path>".

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

-ScanForFeatures

Esegue la ricerca e quindi visualizza una caratteristica. Il parametro ScanForFeatures non installa una caratteristica.

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

-SolutionId

Specifica l'ID soluzione delle caratteristiche. Se non si specifica il parametro SolutionId, verranno ricercati tutti gli ID soluzione.

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