Partager via

Get-Package

  • Référence
Module:
PackageManagement

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

Syntax

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 une 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-Command script ou .Enter-PSSession

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 : 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 les 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 nécessaires pour exécuter des commandes sur l’ordinateur. Le paramètre ScriptBlock exécute l’applet de Get-Package 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 de Uninstall-Package 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 portent le même nom que les commandes installées par un module.

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

-AllowPrereleaseVersions

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

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

-Destination

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

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

-Force

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

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

-ForceBootstrap

Indique que Get-Package force PackageManagement à installer automatiquement le fournisseur de package.

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

-InstallUpdate

Indique que cette applet de commande 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 du package que vous souhaitez rechercher.

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

-MinimumVersion

Spécifie la version minimale du package que vous souhaitez rechercher. Si une version supérieure est disponible, cette version est retournée.

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, ou des noms de package avec des caractères génériques. Séparez plusieurs noms de package par des virgules.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProvider

Spécifie le nom d’un fournisseur de gestion de package.

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. Séparez plusieurs noms de fournisseurs de packages par des virgules. Utilisez Get-PackageProvider pour obtenir la liste des fournisseurs de packages disponibles.

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

-RequiredVersion

Spécifie la version exacte du package à rechercher.

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

-Scope

Spécifie l’étendue de recherche du package.

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

-SkipDependencies

Commutateur qui spécifie d’ignorer la recherche des dépendances de package.

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

-Type

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

Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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, elle retourne chaque package installé.

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, Get-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.