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 -WhatifIn 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 14In 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 15In 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per