Find-Package
Recherche les packages logiciels dans les sources de package disponibles.
Syntax
Find-Package
[-IncludeDependencies]
[-AllVersions]
[-Source <String[]>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Force]
[-ForceBootstrap]
[-ProviderName <String[]>]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[<CommonParameters>]Find-Package
[-IncludeDependencies]
[-AllVersions]
[-Source <String[]>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Force]
[-ForceBootstrap]
[-ProviderName <String[]>]
[-AllowPrereleaseVersions]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[<CommonParameters>]Description
Find-Package recherche les packages logiciels disponibles dans les sources de package. Get-PackageProvider et Get-PackageSource affichent 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 : Rechercher tous les packages disponibles à partir d’un fournisseur de packages
Cette commande recherche tous les packages de module PowerShell disponibles dans une galerie inscrite. Utilisez Get-PackageProvider pour obtenir le nom du fournisseur.
Find-Package -ProviderName NuGet
Name Version Source Summary
---- ------- ------ -------
NUnit 3.11.0 MyNuGet NUnit is a unit-testing framework for all .NET langua...
Newtonsoft.Json 12.0.1 MyNuGet Json.NET is a popular high-performance JSON framework...
EntityFramework 6.2.0 MyNuGet Entity Framework is Microsoft's recommended data acce...
MySql.Data 8.0.15 MyNuGet MySql.Data.MySqlClient .Net Core Class Library
bootstrap 4.3.1 MyNuGet Bootstrap framework in CSS. Includes fonts and JavaSc...
NuGet.Core 2.14.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utilise le paramètre Provider pour spécifier le fournisseur NuGet.
Exemple 2 : Rechercher un package à partir d’une source de package
Cette commande recherche la version la plus récente d’un package à partir d’une source de package spécifiée. Si aucune source de package n’est fournie, Find-Package recherche chaque fournisseur de package installé et ses sources de package. Utilisez Get-PackageSource pour obtenir le nom de la source.
Find-Package -Name NuGet.Core -Source MyNuGet
Name Version Source Summary
---- ------- ------ -------
NuGet.Core 2.14.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utilise le paramètre Name pour spécifier le nom du package NuGet.Core. Le paramètre Source spécifie de rechercher le package dans MyNuGet.
Exemple 3 : Rechercher toutes les versions d’un package
Cette commande recherche toutes les versions de package disponibles à partir d’un fournisseur spécifié.
Find-Package -Name NuGet.Core -Source MyNuGet -AllVersions
Name Version Source Summary
---- ------- ------ -------
NuGet.Core 2.14.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.14.0-rtm-832 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.13.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...
...
NuGet.Core 1.1.229.159 MyNuGet NuGet.Core is the core framework assembly for NuGet...
Nuget.Core 1.0.1120.104 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utilise le paramètre Name pour spécifier le package NuGet.Core. Le paramètre ProviderName spécifie de rechercher le package dans MyNuGet. AllVersions spécifie que toutes les versions disponibles sont retournées.
Exemple 4 : Rechercher un package avec un nom et une version spécifiques
Cette commande recherche une version de package spécifique à partir d’un fournisseur spécifié.
Find-Package -Name NuGet.Core -ProviderName NuGet -RequiredVersion 2.9.0
Name Version Source Summary
---- ------- ------ -------
NuGet.Core 2.9.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utilise le paramètre Name pour spécifier le nom du package NuGet.Core. Le paramètre ProviderName spécifie de rechercher le package dans NuGet. RequiredVersion spécifie que seule la version 2.9.0 est retournée.
Exemple 5 : Rechercher des packages dans une plage de versions
Cette commande recherche une plage de versions pour un package spécifié.
Find-Package -Name NuGet.Core -ProviderName NuGet -MinimumVersion 2.7.0 -MaximumVersion 2.9.0 -AllVersions
Name Version Source Summary
---- ------- ------ -------
NuGet.Core 2.9.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.8.6 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.8.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.7.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utilise le paramètre Name pour spécifier le nom du package NuGet.Core. Le paramètre ProviderName spécifie de rechercher le package dans NuGet. MinimumVersion spécifie la version la plus basse 2.7.0. MaximumVersion spécifie la version 2.9.0 la plus élevée.
AllVersions détermine que la plage est retournée comme spécifié par les valeurs minimale et maximale.
Exemple 6 : Rechercher un package à partir d’un système de fichiers
Cette commande recherche les packages avec l’extension .nupkg de fichier stockés sur l’ordinateur local.
Les fichiers sont des packages téléchargés à partir d’une galerie telle que NuGet.
PS> Find-Package -Source C:\LocalPkg
Name Version Source Summary
---- ------- ------ -------
Microsoft.Web.Xdt 3.0.0 C:\LocalPkg\ Microsoft Xml Document Transformation (XDT)...
NuGet.Core 2.14.0 C:\LocalPkg\ NuGet.Core is the core framework assembly...Paramètres
-AcceptLicense
Accepte automatiquement un contrat de licence si le package l’exige.
| 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 Find-Package retourne toutes les versions disponibles du package. Par défaut, Find-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 |
-Command
Spécifie un tableau de commandes recherchées par Find-Package.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConfigFile
Spécifie un fichier de configuration.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Contains
Find-Package obtient des objets si un élément dans les valeurs de propriété de l’objet correspond exactement à la valeur spécifiée.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Spécifie un compte d’utilisateur autorisé à rechercher des packages.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DscResource
Spécifie un tableau de ressources Desired State Configuration (DSC) que cette applet de commande recherche.
| Type: | String[] |
| 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 la balise qui filtre les résultats. Les résultats qui ne contiennent pas la balise spécifiée sont exclus.
| 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceBootstrap
Indique que Find-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 |
-Headers
Spécifie les en-têtes du package.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeDependencies
Indique que cette applet de commande inclut des dépendances de package dans les résultats.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Includes
Spécifie si Find-Package tous les packages d’une catégorie doivent être trouvés.
Les valeurs acceptées 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 |
-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 |
-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 |
-Proxy
Spécifie un serveur proxy pour la demande, plutôt qu’une connexion directe à la 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 a l'autorisation d'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 un emplacement pour la publication du package.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
Spécifie une version de package exacte que vous souhaitez rechercher.
| 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 |
-ScriptPublishLocation
Spécifie un emplacement de publication de script pour le package.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptSourceLocation
Spécifie un emplacement source de script.
| Type: | String |
| 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 du 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. Utilisez Get-PackageSource pour obtenir la liste des sources de package disponibles. Un répertoire de système de fichiers peut être utilisé comme source de téléchargement de packages.
| 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 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 |
Entrées
None
Vous ne pouvez pas diriger les objets vers cette applet de commande.
Sorties
SoftwareIdentify[]
Cette applet de commande renvoie un objet SoftwareIdentity .
Notes
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.
