Install-SPFeature

Installe un composant fonctionnel SharePoint à l'aide d'un fichier Feature.xml.

Syntax

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

Description

Cette cmdlet contient plus d’un jeu de paramètres. Vous ne pouvez utiliser les paramètres que d’un seul jeu et vous ne pouvez pas combiner les paramètres de différents jeux. Pour plus d’informations sur l’utilisation des jeux de paramètres, consultez les Jeux de paramètres des applets de commande.

L’applet de commande Install-SPFeature installe un objet SPFeature spécifique en fournissant dans le paramètre Identity le chemin d’accès relatif au composant à partir du dossier FEATURES commun à la version spécifique. Le dossier FEATURES spécifique à la version est « $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES » si la collection de sites est en mode 14 et « $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES » si la collection de sites est en mode 15. Les fichiers du composant SharePoint doivent déjà se trouver dans le répertoire correct, soit par le biais d’une opération manuelle, soit par le biais d’un programme d’installation de solution.

Si la valeur du paramètre AllExistingFeatures est true, le système de fichiers est analysé et tous les nouveaux composants fonctionnels qui se trouvent dans les dossiers FEATURES sont installés. Cette opération a généralement lieu dans le cadre d’un déploiement ou d’une mise à niveau seulement.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

--------------EXEMPLE 1-----------------

Install-SPFeature -path "MyCustomFeature"

Cet exemple installe une nouvelle fonctionnalité dans $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature/feature.xml.

--------------EXEMPLE 2-----------------

Install-SPFeature -AllExistingFeatures -Whatif

Cet exemple affiche les composants fonctionnels non enregistrés, disponibles sur le système de fichiers, qui sont installés si cette commande est exécutée sans le paramètre WhatIf. Cette opération est couramment utilisée suite à un processus de mise à niveau.

--------------EXEMPLE 3-----------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 14

Cet exemple installe une nouvelle fonctionnalité dans $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

--------------EXEMPLE 4-----------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 15

Cet exemple installe un nouveau composant fonctionnel dans $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

Paramètres

-AllExistingFeatures

Recherche les composants fonctionnels existants, mais non enregistrés, puis les enregistre auprès de la batterie.

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

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

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

-CompatibilityLevel

Spécifie la version du composant fonctionnel à installer. Quand la version n'est pas spécifiée, la valeur MaxVersion des applications web est utilisée.

Les valeurs de ce peut être 14 ou 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

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : 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

Force l'installation d'un composant fonctionnel déjà installé.

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

-Path

Spécifie un chemin d'accès de fichier authentique, par exemple, MonComposantFonctionnel.

Le chemin d'accès au composant fonctionnel doit être un chemin d'accès littéral au répertoire 14\Template\Features. Le nom de fichier feature.xml est supposé et il est inutile de le fournir.

Si le chemin d’accès à la fonctionnalité est introuvable, le message d’erreur suivant s’affiche : « Impossible de trouver le fichier XML à l’emplacement 14\Template\Features\<chemin> du fichier ».

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

-ScanForFeatures

Analyse et affiche un composant fonctionnel. Le paramètre ScanForFeatures n'installe aucun composant fonctionnel.

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

-SolutionId

Spécifie l'ID de solution des composants fonctionnels. Si le paramètre SolutionId n'est pas spécifié, tous les ID de solution sont analysés.

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

-WhatIf

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : 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