Partager via


Install-SPWebPartPack

Installe le package de composants WebPart indiqué à l'emplacement spécifié.

Syntax

Install-SPWebPartPack
       [-LiteralPath] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-GlobalInstall]
       [-Language <UInt32>]
       [-WebApplication <SPWebApplicationPipeBind>]
       [-WhatIf]
       [-CompatibilityLevel <String>]
       [<CommonParameters>]
Install-SPWebPartPack
       [-Name] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-GlobalInstall]
       [-Language <UInt32>]
       [-WebApplication <SPWebApplicationPipeBind>]
       [-WhatIf]
       [-CompatibilityLevel <String>]
       [<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-SPWebPartPack installe le package de composants WebPart à l’emplacement du paramètre LiteralPath dans la batterie de serveurs locale. Le package de composants WebPart peut être installé dans une application web spécifique à l’aide du paramètre WebApplication. Si aucune application web n’est spécifiée, le package de composants WebPart est installé dans toutes les applications web.

Utilisez le paramètre Language pour spécifier une langue pour le package.

Utilisez le paramètre GlobalInstall pour installer le package sur le Global Assembly Cache (GAC). Les assemblys du GAC jouissent d’une autorisation FullTrust, qui donne à ce package un accès complet à toutes les ressources du système.

Utilisez le paramètre Force pour installer le package et remplacer tout package de composants WebPart existant du même nom ou installé au même emplacement.

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

Install-SPWebPartPack "MyCustomWebPartPack" -LiteralPath "C:\mywebpart.wpp" -GlobalInstall

Cet exemple installe le package de composants WebPart nommé MyCustomWebPartPack dans toute la batterie à partir du chemin d’accès c:/mywebpart.wpp.

Paramètres

-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 des modèles à utiliser lors de la création d'un objet SPSite. Cette valeur définit la valeur initiale de CompatibilityLevel pour la collection de sites. Quand ce paramètre n’est pas spécifié, CompatibilityLevel prend par défaut la valeur de la version la plus élevée possible pour l’application web en fonction du paramètre SiteCreationMode.

Type:String
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

Remplace tout package de composant WebPart existant du même nom ou installé au même emplacement.

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

-GlobalInstall

Installe le package de composants WebPart dans le Global Assembly Cache (GAC) plutôt que dans le répertoire /bin de chaque application web. Cette installation rend le composant WebPart accessible de manière globale sur les serveurs.

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

-Language

Spécifie l'ID de langue du package de composants WebPart.

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

-LiteralPath

Spécifie le chemin d'accès exact vers le package de composants WebPart.

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

-Name

Spécifie le nom du package de composants WebPart à installer.

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

-WebApplication

Spécifie l'application web sur laquelle installer le package de composants WebPart. Si aucune application web n'est spécifiée, le package de composants WebPart est installé dans toutes les applications web.

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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