Find-Module
Recherche des modules dans un référentiel qui correspondent aux critères spécifiés.
Syntaxe
All
Find-Module
[[-Name] <string[]>]
[-MinimumVersion <string>]
[-MaximumVersion <string>]
[-RequiredVersion <string>]
[-AllVersions]
[-IncludeDependencies]
[-Filter <string>]
[-Tag <string[]>]
[-Includes <string[]>]
[-DscResource <string[]>]
[-RoleCapability <string[]>]
[-Command <string[]>]
[-Proxy <uri>]
[-ProxyCredential <pscredential>]
[-Repository <string[]>]
[-Credential <pscredential>]
[-AllowPrerelease]
[<CommonParameters>]
Description
L’applet Find-Module de commande recherche des modules dans un référentiel qui correspondent aux critères spécifiés.
Find-Module retourne un objet PSRepositoryItemInfo pour chaque module trouvé. Les objets peuvent être envoyés vers le bas du pipeline aux applets de commande telles que Install-Module.
La première fois que Find-Module vous tentez d’utiliser un référentiel, vous serez peut-être invité à installer les mises à jour.
Si la source du référentiel n’est pas inscrite auprès Register-PSRepository de l’applet de commande, une erreur est retournée.
Find-Module retourne la version la plus récente d’un module si aucun paramètre n’est utilisé pour limiter la version. Pour obtenir la liste d’un référentiel des versions d’un module, utilisez le paramètre AllVersions.
Si le paramètre MinimumVersion est spécifié, Find-Module retourne la version du module égale ou supérieure à la valeur minimale. S’il existe une version plus récente disponible dans le référentiel, la version la plus récente est retournée.
Si le paramètre MaximumVersion est spécifié, Find-Module retourne la version la plus récente du module qui ne dépasse pas la version spécifiée.
Si le paramètre RequiredVersion est spécifié, Find-Module retourne uniquement la version du module qui correspond exactement à la version spécifiée.
Find-Module effectue des recherches dans tous les modules disponibles, car les conflits de noms entre les sources peuvent se produire.
Les paramètres qui prennent les numéros de version du module s’attendent à ce que les chaînes mises en forme en tant que numéros de version.
- Les numéros de version standard ont un format où
x.y.zx, y et z sont des nombres - Les versions préliminaires ont un format où
x.y.z-<prerelease_label>la<prerelease_label>chaîne arbitraire affectée à cette version est arbitraire.
Les exemples suivants utilisent PowerShell Gallery comme seul dépôt inscrit.
Get-PSRepository affiche les référentiels inscrits. Si vous avez plusieurs référentiels inscrits, utilisez le -Repository paramètre pour spécifier le nom du référentiel.
Exemples
Exemple 1 : Rechercher un module par nom
Cet exemple recherche un module dans le référentiel par défaut.
Find-Module -Name PowerShellGet
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
L’applet Find-Module de commande utilise le paramètre Name pour spécifier le module PowerShellGet .
Exemple 2 : Rechercher des modules avec des noms similaires
Cet exemple utilise le caractère générique astérisque (*) pour rechercher des modules avec des noms similaires.
Find-Module -Name PowerShell*
Version Name Repository Description
------- ---- ---------- -----------
0.4.0 powershell-yaml PSGallery Powershell module for serializing and...
2.1.0 PowerShellGet PSGallery PowerShell module with commands for...
1.9 Powershell.Helper.Extension PSGallery # Powershell.Helper.Extension...
3.1 PowerShellHumanizer PSGallery PowerShell Humanizer wraps Humanizer...
4.0 PowerShellISEModule PSGallery a module that adds capability to the ISE
L’applet Find-Module de commande utilise le paramètre Name avec le caractère générique astérisque (*) pour rechercher tous les modules qui contiennent PowerShell.
Exemple 3 : Rechercher un module par version minimale
Cet exemple recherche la version minimale d’un module. Si le référentiel contient une version plus récente du module, la version la plus récente est retournée.
Find-Module -Name PowerShellGet -MinimumVersion 1.6.5
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
L’applet Find-Module de commande utilise le paramètre Name pour spécifier le module PowerShellGet .
MinimumVersion spécifie la version 1.6.5.
Find-Module retourne PowerShellGet version 2.1.0 , car il dépasse la version minimale et est la version la plus récente.
Exemple 4 : Rechercher un module par version spécifique
Cet exemple montre comment installer une version préliminaire spécifique d’un module. Les versions préliminaires ont un format de <version_number>-<prerelease_label>.
Find-Module PSReadLine -AllowPrerelease -RequiredVersion 2.2.4-beta1
Version Name Repository Description
------- ---- ---------- -----------
2.2.4-beta1 PSReadLine PSGallery Great command line editing in the PowerS…
Exemple 5 : Rechercher un module dans un référentiel spécifique
Cet exemple utilise le paramètre Référentiel pour rechercher un module dans un référentiel spécifique.
Find-Module -Name PowerShellGet -Repository PSGallery
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
L’applet Find-Module de commande utilise le paramètre Name pour spécifier le module PowerShellGet . Le paramètre Repository spécifie de rechercher dans le référentiel PSGallery .
Exemple 6 : Rechercher un module dans plusieurs référentiels
Cet exemple utilise la méthode Register-PSRepository pour spécifier un référentiel.
Find-Module utilise le référentiel pour rechercher un module.
Register-PSRepository -Name MySource -SourceLocation https://www.myget.org/F/powershellgetdemo/
Find-Module -Name Contoso* -Repository PSGallery, MySource
Repository Version Name Description
---------- ------- ---- -----------
PSGallery 2.0.0.0 ContosoServer Cmdlets and DSC resources for managing Contoso Server...
MySource 1.2.0.0 ContosoClient Cmdlets and DSC resources for managing Contoso Client...
L’applet Register-PSRepository de commande inscrit un nouveau référentiel. Le paramètre Name attribue le nom MySource. Le paramètre SourceLocation spécifie l’adresse du référentiel.
L’applet Find-Module de commande utilise le paramètre Name avec le caractère générique astérisque (*) pour spécifier le module Contoso . Le paramètre Référentiel spécifie de rechercher deux référentiels, PSGallery et MySource.
Exemple 7 : Rechercher un module qui contient une ressource DSC
Cette commande retourne des modules qui contiennent des ressources DSC. Le paramètre Includes comporte quatre fonctionnalités prédéfinies utilisées pour effectuer une recherche dans le référentiel. Utilisez tabulation pour afficher les quatre fonctionnalités prises en charge par le paramètre Includes .
Find-Module -Repository PSGallery -Includes DscResource
Version Name Repository Description
------- ---- ---------- -----------
2.7.0 Carbon PSGallery Carbon is a PowerShell module...
8.5.0.0 xPSDesiredStateConfiguration PSGallery The xPSDesiredStateConfiguration module...
1.3.1 PackageManagement PSGallery PackageManagement (a.k.a. OneGet) is...
2.7.0.0 xWindowsUpdate PSGallery Module with DSC Resources...
3.2.0.0 xCertificate PSGallery This module includes DSC resources...
3.1.0.0 xPowerShellExecutionPolicy PSGallery This DSC resource can change the user...
L’applet Find-Module de commande utilise le paramètre Référentiel pour rechercher dans le référentiel , PSGallery.
Le paramètre Includes spécifie DscResource, qui est une fonctionnalité que le paramètre peut rechercher dans le référentiel.
Exemple 8 : Rechercher un module avec un filtre
Dans cet exemple, pour rechercher des modules, un filtre est utilisé pour rechercher le référentiel.
Pour un référentiel NuGet, le paramètre Filter recherche le nom, la description et les balises de l’argument.
Find-Module -Filter AppDomain
Version Name Repository Description
------- ---- ---------- -----------
1.0.0.0 AppDomainConfig PSGallery Manipulate AppDomain configuration...
1.1.0 ClassExplorer PSGallery Quickly search the AppDomain for classes...
L’applet Find-Module de commande utilise le paramètre Filter pour rechercher le référentiel pour AppDomain.
Exemple 9 : Rechercher un module par balise
Cet exemple montre comment rechercher des modules par une balise. La CrescendoBuilt valeur est une balise qui est automatiquement ajoutée aux modules créés à l’aide du module Microsoft.PowerShell.Crescendo .
Find-Module -Tag CrescendoBuilt
Version Name Repository Description
------- ---- ---------- -----------
0.1.0 Foil PSGallery A PowerShell Crescendo wrapper for Chocolatey
0.3.1 Cobalt PSGallery A PowerShell Crescendo wrapper for WinGet
1.1.0 SysInternals PSGallery PowerShell cmdlets for SysInternal tools
0.0.4 Croze PSGallery A PowerShell Crescendo wrapper for Homebrew
0.0.2 AptPackage PSGallery PowerShell Crescendo-generated Module to query APT-Package Information
1.0.1 RoboCopy PSGallery PowerShell cmdlet for the official RoboCopy.exe
1.0.2 TShark PSGallery PowerShell cmdlet for tshark.exe
1.0.0 SpeedTestCLI PSGallery PowerShell cmdlets speedtest-cli
1.0.0 SpeedTest-CLI PSGallery PowerShell cmdlets for Internet Speed Test
1.0.2 Image2Text PSGallery PowerShell Images into ASCII art
0.1.1 Quser.Crescendo PSGallery This module displays session information of users logged onto a local or remote m...
1.0.2 Takeown PSGallery Crescendo Powershell wrapper of takeown.exe
Paramètres
-AllowPrerelease
Inclut dans les modules de résultats marqués comme préversion.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AllVersions
Spécifie d’inclure toutes les versions d’un module dans les résultats. Vous ne pouvez pas utiliser le paramètre AllVersions avec les paramètres MinimumVersion, MaximumVersion ou RequiredVersion .
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Command
Spécifie un tableau de commandes à rechercher dans les modules. Une commande peut être une fonction ou un workflow.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Credential
Spécifie un compte d’utilisateur disposant des droits d’installation d’un module pour un fournisseur de package ou une source spécifié.
Propriétés des paramètres
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-DscResource
Spécifie le nom, ou une partie du nom, des modules qui contiennent des ressources DSC. Par conventions PowerShell, effectue une recherche OR lorsque vous fournissez plusieurs arguments.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Filter
Spécifie un filtre basé sur la syntaxe de recherche spécifique au fournisseur PackageManagement . Pour les modules NuGet, ce paramètre est l’équivalent de la recherche à l’aide de la barre de recherche sur le site web PowerShell Gallery .
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IncludeDependencies
Indique que cette opération inclut tous les modules qui dépendent du module spécifié dans le paramètre Name .
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Includes
Retourne uniquement les modules qui incluent des types spécifiques de fonctionnalités PowerShell. Par exemple, vous pouvez uniquement rechercher des modules qui incluent DSCResource. Les valeurs acceptables pour ce paramètre sont les suivantes :
- cmdlet
- DscResource
- Fonction
- RôleCapacité
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Valeurs acceptées: | DscResource, Cmdlet, Function, RoleCapability |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MaximumVersion
Spécifie la version maximale ou la plus récente du module à inclure dans les résultats de recherche. MaximumVersion et RequiredVersion ne peuvent pas être utilisés dans la même commande.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-MinimumVersion
Spécifie la version minimale du module à inclure dans les résultats. MinimumVersion et RequiredVersion ne peuvent pas être utilisés dans la même commande.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Name
Spécifie les noms des modules à rechercher dans le référentiel. Une liste séparée par des virgules des noms de modules est acceptée. Les caractères génériques sont acceptés.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Proxy
Spécifie un serveur proxy pour la requête, au lieu de se connecter directement à la ressource Internet.
Propriétés des paramètres
| Type: | Uri |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ProxyCredential
Spécifie un compte d’utilisateur autorisé à utiliser le serveur proxy spécifié par le paramètre Proxy .
Propriétés des paramètres
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Repository
Utilisez le paramètre Référentiel pour spécifier le référentiel à rechercher dans un module. Utilisé lorsque plusieurs référentiels sont inscrits. Accepte une liste de référentiels séparés par des virgules. Pour inscrire un référentiel, utilisez Register-PSRepository. Pour afficher les référentiels inscrits, utilisez Get-PSRepository.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RequiredVersion
Spécifie le numéro de version exact du module à inclure dans les résultats. RequiredVersion ne peut pas être utilisé dans la même commande que MinimumVersion ou MaximumVersion.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-RoleCapability
Spécifie un tableau de fonctionnalités de rôle.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Tag
Spécifie un tableau de balises. Les exemples de balises incluent DesiredStateConfiguration, DSC, DSCResourceKit ou PSModule.
Propriétés des paramètres
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
String
String
Uri
PSCredential
Sorties
PSRepositoryItemInfo
Find-Module crée des objets PSRepositoryItemInfo qui peuvent être envoyés vers le bas du pipeline aux applets de commande telles que Install-Module.
Notes
PowerShell inclut les alias suivants pour Find-Module:
- Toutes les plateformes :
fimo
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.
