Partager via

Install-Package

  • Référence
Module:
PackageManagement

Installe un ou plusieurs packages logiciels.

Syntaxe

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 logicielles, utilisez Get-PackageProvider et Get-PackageSource affichez 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 dans 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 le nom et la source des packages. Le paramètre Credential utilise un compte d’utilisateur de domaine avec des autorisations 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é vers le bas du 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 logicielles.

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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowClobber

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowPrereleaseVersions

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Command

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConfigFile

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie un compte d’utilisateur autorisé à accéder à l’ordinateur et à 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 Get-Credential de 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Destination

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DscResource

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExcludeVersion

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Filter

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceBootstrap

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Headers

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 :

  • cmdlet
  • DscResource
  • Fonction
  • RoleCapability
  • Flux de travail
Type:String[]
Valeurs acceptées:Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Accepte l'entrée 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InstallUpdate

Indique que Install-Package les mises à jour sont installées.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 à n’importe quelle version spécifiée par le paramètre MaximumVersion .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PackageManagementProvider

Spécifie le nom du fournisseur PackageManagement .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ProviderName

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

Type:String[]
Alias:Provider
Valeurs acceptées:Bootstrap, NuGet, PowerShellGet
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Proxy

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

Type:Uri
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ProxyCredential

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

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublishLocation

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RequiredVersion

Spécifie la version exacte 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 à n’importe quelle version spécifiée par le paramètre MaximumVersion .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RoleCapability

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Scope

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

  • Utilisateur actuel
  • AllUsers
Type:String
Valeurs acceptées:CurrentUser, AllUsers
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScriptPublishLocation

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScriptSourceLocation

Spécifie l’emplacement source du script.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SkipDependencies

Ignore l’installation des dépendances logicielles.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SkipPublisherCheck

Vous permet d’obtenir une version de package plus récente que celle de votre 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SkipValidate

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Source

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Tag

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
  • Scénario
  • Tous
Type:String
Valeurs acceptées:Module, Script, All
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passe si Install-Package l’applet de commande est exécutée. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 les 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 ensembles de paramètres d’une applet de commande et inclut le jeu de paramètres du fournisseur. Par exemple, Install-Package le jeu de paramètres PowerShellGet inclut -NoPathUpdate, AllowClobberet SkipPublisherCheck.

Important

Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Si vous n’utilisez pas TLS 1.2 ou version ultérieure, vous recevez une erreur lors de la tentative d’accès à 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 dans le blog PowerShell.