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 <version>]
[-MaximumVersion <version>]
[-RequiredVersion <version>]
[-AllVersions]
[-IncludeDependencies]
[-Filter <string>]
[-Tag <string[]>]
[-Includes <string[]>]
[-DscResource <string[]>]
[-Command <string[]>]
[-Repository <string[]>]
[<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 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 retourne un objet qui représente la version spécifique d’un module. Si la version spécifiée est introuvable, une erreur est renvoyée.
Find-Module -Name PowerShellGet -RequiredVersion 1.6.5
Version Name Repository Description
------- ---- ---------- -----------
1.6.5 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 RequiredVersion spécifie la version 1.6.5.
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.
Paramètres
-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 du paramètre
| 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 du paramètre
| 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 |
-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 du paramètre
| 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 d’une recherche à l’aide de la barre de recherche sur le site web de la galerie PowerShell .
Propriétés du paramètre
| 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 du paramètre
| 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 du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Valeurs acceptées: | Cmdlet, DscResource, 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 du paramètre
| Type: | Version |
| 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 du paramètre
| Type: | Version |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Version |
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 du paramètre
| 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 |
-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 du paramètre
| 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 du paramètre
| Type: | Version |
| 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 |
-Tag
Spécifie un tableau de balises. Les exemples de balises incluent DesiredStateConfiguration, DSC, DSCResourceKit ou PSModule.
Propriétés du paramètre
| 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.
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
Cette applet de commande s’exécute sur PowerShell 5.0 ou versions ultérieures de Windows PowerShell, sur Windows 7 ou Windows 2008 R2 et versions ultérieures de Windows.