Get-Package

Référence

Module:: PackageManagement

Retourne la liste de tous les packages logiciels installés avec PackageManagement.

Syntaxe

Get-Package
   [[-Name] <String[]>]
   [-RequiredVersion <String>]
   [-MinimumVersion <String>]
   [-MaximumVersion <String>]
   [-AllVersions]
   [-Force]
   [-ForceBootstrap]
   [-ProviderName <String[]>]
   [-Destination <String>]
   [-ExcludeVersion]
   [-Scope <String>]
   [-SkipDependencies]
   [<CommonParameters>]

Get-Package
   [[-Name] <String[]>]
   [-RequiredVersion <String>]
   [-MinimumVersion <String>]
   [-MaximumVersion <String>]
   [-AllVersions]
   [-Force]
   [-ForceBootstrap]
   [-ProviderName <String[]>]
   [-Scope <String>]
   [-PackageManagementProvider <String>]
   [-Type <String>]
   [-AllowClobber]
   [-SkipPublisherCheck]
   [-InstallUpdate]
   [-NoPathUpdate]
   [-AllowPrereleaseVersions]
   [<CommonParameters>]

Description

L’applet Get-Package de commande retourne la liste de tous les packages logiciels sur l’ordinateur local qui ont été installés avec PackageManagement. Vous pouvez exécuter Get-Package sur des ordinateurs distants en l’exécutant dans le cadre d’une commande ou d’un Invoke-CommandEnter-PSSession script.

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 : Obtenir tous les packages installés

L’applet Get-Package de commande obtient tous les packages installés sur l’ordinateur local.

Get-Package

Name           Version      Source                                     ProviderName
----           -------      ------                                     ------------
posh-git       0.7.3        https://www.powershellgallery.com/api/v2   PowerShellGet

Exemple 2 : Obtenir des packages installés sur un ordinateur distant

Cette commande obtient la liste des packages qui ont été installés par PackageManagement sur un ordinateur distant. Cette commande vous invite à fournir le mot de passe de l’utilisateur spécifié.

PS> Invoke-Command -ComputerName Server01 -Credential CONTOSO\TestUser -ScriptBlock {Get-Package}

Invoke-Command utilise le paramètre ComputerName pour spécifier un ordinateur distant, Server01. Le paramètre Credential spécifie un domaine et un nom d’utilisateur disposant des autorisations d’exécution des commandes sur l’ordinateur. Le paramètre ScriptBlock exécute l’applet Get-Package de commande sur l’ordinateur distant.

Exemple 3 : Obtenir des packages pour un fournisseur spécifié

Cette commande obtient les packages logiciels installés sur l’ordinateur local à partir d’un fournisseur spécifique.

Get-Package -ProviderName PowerShellGet -AllVersions

Name                  Version      Source                                     ProviderName
----                  -------      ------                                     ------------
PackageManagement     1.2.2        https://www.powershellgallery.com/api/v2   PowerShellGet
PackageManagement     1.3.1        https://www.powershellgallery.com/api/v2   PowerShellGet
posh-git              0.7.3        https://www.powershellgallery.com/api/v2   PowerShellGet
PowerShellGet         2.0.1        https://www.powershellgallery.com/api/v2   PowerShellGet

Get-Package utilise le paramètre ProviderName pour spécifier un fournisseur spécifique, PowerShellGet. Le paramètre AllVersions affiche chaque version installée.

Exemple 4 : Obtenir une version exacte d’un package spécifique

Cette commande obtient une version spécifique d’un package installé. Plusieurs versions d’un package peuvent être installées.

Get-Package -Name PackageManagement -ProviderName PowerShellGet -RequiredVersion 1.3.1

Name                  Version      Source                                     ProviderName
----                  -------      ------                                     ------------
PackageManagement     1.3.1        https://www.powershellgallery.com/api/v2   PowerShellGet

Get-Package utilise le paramètre Name pour spécifier le nom du package, PackageManagement. Le paramètre ProviderName spécifie le fournisseur , PowerShellGet. Le paramètre RequiredVersion spécifie une version installée.

Exemple 5 : Désinstaller un package

Cet exemple obtient des informations sur le package, puis désinstalle le package.

Get-Package -Name posh-git -RequiredVersion 0.7.3 | Uninstall-Package

Get-Package utilise le paramètre Name pour spécifier le nom du package, posh-git. Le paramètre RequiredVersion est une version spécifique du package. L’objet est envoyé vers le bas du pipeline à l’applet Uninstall-Package de commande. Uninstall-Package supprime le package.

Paramètres

-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 installées par un module.

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

Inclut les packages marqués comme une préversion dans les résultats.

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

Indique que Get-Package retourne toutes les versions disponibles du package. Par défaut, Get-Package retourne uniquement la version la plus récente disponible.

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

-Destination

Spécifie le chemin d’accès à un répertoire qui contient des fichiers de package extraits.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

Indique que Get-PackagePackageManagement doit installer automatiquement le fournisseur de 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

-InstallUpdate

Indique que cette applet de commande installe les mises à jour.

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 du package que vous souhaitez rechercher.

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 du package que vous souhaitez rechercher. Si une version ultérieure est disponible, cette version est retourné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

-Name

Spécifie un ou plusieurs noms de package ou noms de package avec des caractères génériques. Séparez plusieurs noms de package par des virgules.

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

-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 Get-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 d’un fournisseur de gestion 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

-ProviderName

Spécifie un ou plusieurs noms de fournisseurs de package. Séparez plusieurs noms de fournisseurs de package avec des virgules. Permet Get-PackageProvider d’obtenir la liste des fournisseurs de packages disponibles.

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

-RequiredVersion

Spécifie la version exacte du package à rechercher.

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 de recherche du package.

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

-SkipDependencies

Basculez qui spécifie d’ignorer la recherche de dépendances de 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

-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

-Type

Spécifie s’il faut rechercher des packages avec un module, un script ou l’un ou l’autre.

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

Sorties

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Cette applet de commande retourne un objet SoftwareIdentity pour chaque package installé qui correspond aux paramètres. Par défaut, il retourne chaque package installé.

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, Get-Package le jeu de paramètres PowerShellGet inclut -NoPathUpdate, AllowClobberet SkipPublisherCheck.