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:Programmi\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES" se la raccolta siti è in modalità 14 e "$env:Programmi\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.

If the value of the AllExistingFeatures parameter is true, the file system is scanned and all new features that are in both FEATURES folders are installed. This is generally only used during deployment and upgrade.

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 caratteristica in $env:Programmi\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature/feature.xml.

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

Install-SPFeature -AllExistingFeatures -Whatif

This example shows the unregistered features that are available on the file system and that are installed if this command is run without the WhatIf parameter. This is commonly done after an upgrade process.

--------------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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Path

Specifica un percorso di file autentico, ad esempio CaratteristicaPersonalizzata.

The path to feature must be a literal path to the 14\Template\Features directory. The feature.xml file name is implied and does not need to be provided.

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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

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