Partager via

Install-Package

  • Référence
Module:
PackageManagement

Installe un ou plusieurs packages logiciels.

Syntax

Install-Package
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Source <String[]>]
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ProviderName <String[]>]
       [<CommonParameters>]
Install-Package
       [-InputObject] <SoftwareIdentity[]>
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Description

L’applet Install-Package de commande installe un ou plusieurs packages logiciels sur l’ordinateur local. Si vous avez plusieurs sources de logiciels, utilisez Get-PackageProvider et Get-PackageSource pour afficher des détails sur vos fournisseurs.

Important

Les commandes contenues dans le module PackageManagement sont différentes des commandes fournies par le module NuGet dans la console du Gestionnaire de package de Visual Studio. Chaque module a des commandes qui ne sont pas disponibles dans l’autre. Les commandes portant le même nom diffèrent par leurs arguments spécifiques. Pour plus d’informations, consultez la documentation de référence PowerShell pour la console du Gestionnaire de package de Visual Studio.

Exemples

Exemple 1 : Installer un package par nom de package

L’applet Install-Package de commande installe un package logiciel et ses dépendances.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Install-Package utilise des paramètres pour spécifier les packages Name et Source. Le paramètre Credential utilise un compte d’utilisateur de domaine disposant des autorisations nécessaires pour installer des packages. La commande vous invite à entrer le mot de passe du compte d’utilisateur.

Exemple 2 : Utiliser Find-Package pour installer un package

Dans cet exemple, l’objet retourné par Find-Package est envoyé vers le bas du pipeline et installé par Install-Package.

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-Package utilise les paramètres Name et Source pour localiser un package. L’objet est envoyé dans le pipeline et Install-Package installe le package sur l’ordinateur local.

Exemple 3 : Installer des packages en spécifiant une plage de versions

Install-Package utilise les paramètres MinimumVersion et MaximumVersion pour spécifier une plage de versions de logiciels.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

Install-Package utilise les paramètres Name et Source pour rechercher un package. Les paramètres MinimumVersion et MaximumVersion spécifient une plage de versions logicielles. La version la plus élevée de la plage est installée.

Paramètres

-AcceptLicense

AcceptLicense accepte automatiquement le contrat de licence pendant l’installation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowClobber

Remplace les messages d’avertissement concernant les conflits avec les commandes existantes. Remplace les commandes existantes qui portent le même nom que les commandes en cours d’installation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowPrereleaseVersions

Autorise l’installation de packages marqués comme préversion.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

Install-Package installe toutes les versions disponibles du package. Par défaut, seule la version la plus récente est installée.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Command

Spécifie une ou plusieurs commandes qui effectuent Install-Package une recherche.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConfigFile

Spécifie un chemin d’accès qui contient un fichier de configuration.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Contains

Install-Package obtient des objets si le paramètre Contains spécifie une valeur qui correspond à l’une des valeurs de propriété de l’objet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Spécifie un compte d’utilisateur qui a l’autorisation d’accéder à l’ordinateur et d’exécuter des commandes. Tapez un nom d’utilisateur, tel que User01, Domain01\User01, ou entrez un objet PSCredential , généré par l’applet de Get-Credential commande . Si vous tapez un nom d’utilisateur, vous êtes invité à entrer un mot de passe.

Lorsque le paramètre Credential n’est pas spécifié, Install-Package utilise l’utilisateur actuel.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Spécifie un chemin d’accès à un objet d’entrée.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DscResource

Spécifie une ou plusieurs ressources Desired State Configuration (DSC) recherchées par Install-Package. Utilisez l’applet Find-DscResource de commande pour rechercher des ressources DSC.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeVersion

Basculez pour exclure le numéro de version dans le chemin du dossier.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Spécifie les termes à rechercher dans les propriétés Name et Description .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilterOnTag

Spécifie une balise qui filtre les résultats et exclut les résultats qui ne contiennent pas la balise spécifiée.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur. Remplace les restrictions qui empêchent Install-Package de réussir, à l’exception de la sécurité.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceBootstrap

Force PackageManagement à installer automatiquement le fournisseur de package pour le package spécifié.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Headers

Spécifie les en-têtes de package.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Includes

Spécifie si Install-Package tous les types de package doivent être trouvés. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Applet de commande
  • DscResource
  • Fonction
  • RoleCapability
  • Workflow
Type:String[]
Accepted values:Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Accepte l’entrée de pipeline. Spécifie un package à l’aide du type SoftwareIdentity du package. Find-Package génère un objet SoftwareIdentity .

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstallUpdate

Indique que Install-Package installe les mises à jour.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

Spécifie la version maximale autorisée du package que vous souhaitez installer. Si vous ne spécifiez pas ce paramètre, Install-Package installe la version la plus récente du package.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

Spécifie la version minimale autorisée du package que vous souhaitez installer. Si vous n’ajoutez pas ce paramètre, Install-Package installe la version la plus récente du package qui satisfait à toute version spécifiée par le paramètre MaximumVersion .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie un ou plusieurs noms de package. Plusieurs noms de package doivent être séparés par des virgules.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoPathUpdate

NoPathUpdate s’applique uniquement à l’applet de Install-Script commande. NoPathUpdate est un paramètre dynamique ajouté par le fournisseur et n’est pas pris en charge par Install-Package.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProvider

Spécifie le nom du fournisseur PackageManagement .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProviderName

Spécifie un ou plusieurs noms de fournisseurs de packages auxquels définir l’étendue de votre recherche de package. Vous obtenez les noms des fournisseurs de package en exécutant l’applet de commande Get-PackageProvider.

Type:String[]
Aliases:Provider
Accepted values:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Proxy

Spécifie un serveur proxy pour la demande, au lieu de se connecter directement à une ressource Internet.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

Spécifie un compte d’utilisateur qui est autorisé à utiliser le serveur proxy spécifié par le paramètre Proxy .

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishLocation

Spécifie le chemin d’accès à l’emplacement publié d’un package.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

Spécifie la version autorisée exacte du package que vous souhaitez installer. Si vous n’ajoutez pas ce paramètre, Install-Package installe la version la plus récente du package qui satisfait à toute version spécifiée par le paramètre MaximumVersion .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleCapability

Spécifie un tableau de fonctionnalités de rôle.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Spécifie l’étendue pour laquelle installer le package. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Utilisateur en cours
  • AllUsers
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptPublishLocation

Spécifie le chemin d’accès à l’emplacement publié d’un script.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptSourceLocation

Spécifie l’emplacement source du script.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencies

Ignore l’installation des dépendances logicielles.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipPublisherCheck

Vous permet d’obtenir une version de package plus récente que la version installée. Par exemple, un package installé signé numériquement par un éditeur approuvé, mais une nouvelle version n’est pas signée numériquement.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipValidate

Commutateur qui ignore la validation des informations d’identification d’un package.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Source

Spécifie une ou plusieurs sources de package. Plusieurs noms de source de package doivent être séparés par des virgules. Vous pouvez obtenir des noms de source de package en exécutant l’applet de Get-PackageSource commande .

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Spécifie une ou plusieurs chaînes à rechercher dans les métadonnées du package.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Spécifie s’il faut rechercher des packages avec un module, un script ou les deux. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Module
  • Script
  • Tous
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Affiche ce qui se passerait si Install-Package l’applet de commande est exécutée. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Vous pouvez diriger un objet SoftwareIdentity vers cette applet de commande.

Sorties

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Cette applet de commande retourne un objet SoftwareIdentity pour chaque package qu’il installe.

Notes

L’inclusion d’un fournisseur de package dans une commande peut rendre des paramètres dynamiques disponibles pour une applet de commande. Les paramètres dynamiques sont spécifiques à un fournisseur de package. L’applet Get-Help de commande répertorie les jeux de paramètres d’une applet de commande et inclut l’ensemble de paramètres du fournisseur. Par exemple, Install-Package a le paramètre PowerShellGet défini qui inclut -NoPathUpdate, AllowClobberet SkipPublisherCheck.

Important

Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions 1.0 et 1.1 de Transport Layer Security (TLS). Si vous n'utilisez pas TLS 1.2 ou une version plus récente, vous recevez une erreur lorsque vous tentez d'accéder à PowerShell Gallery. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Pour plus d’informations, consultez l’annonce sur le blog PowerShell.