Find-Module

Référence

Module:: PowerShellGet

Recherche les modules dans un référentiel qui correspondent aux critères spécifiés.

Syntax

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 les modules dans un référentiel qui correspondent aux critères spécifiés. Find-Module retourne un objet PSRepositoryItemInfo pour chaque module qu’il trouve. Les objets peuvent être envoyés vers le bas du pipeline à des applets de commande telles que Install-Module.

La première fois Find-Module que vous tentez d’utiliser un dépôt, vous pouvez être invité à installer des mises à jour. Si la source du dépôt n’est pas inscrite avec Register-PSRepository 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 des versions d’un module dans un dépôt, utilisez le paramètre AllVersions.

Si le paramètre MinimumVersion est spécifié, Find-Module retourne la version du module qui est égale ou supérieure à la valeur minimale. Si une version plus récente est disponible dans le dépôt, 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 recherche tous les modules disponibles, car des conflits de noms peuvent se produire entre les sources.

Les paramètres qui acceptent des numéros de version de module attendent des chaînes mises en forme en tant que numéros de version.

Les numéros de version standard ont un format où x.y.z x, y et z sont des nombres
Les versions préliminaires ont un format où x.y.z-<prerelease_label> est <prerelease_label> une chaîne arbitraire affectée à cette mise en production.

Les exemples suivants utilisent le PowerShell Gallery comme seul dépôt inscrit. Get-PSRepository affiche les dépôts inscrits. Si vous avez plusieurs référentiels inscrits, utilisez le -Repository paramètre pour spécifier le nom du dépôt.

Exemples

Exemple 1 : Rechercher un module par son 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 dépôt 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 elle 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 préversion 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 Repository pour rechercher un module dans un dépôt 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 la recherche dans le référentiel PSGallery .

Exemple 6 : Rechercher un module dans plusieurs dépôts

Cet exemple utilise pour Register-PSRepository spécifier un dépôt. 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 dépôt. Le paramètre Name attribue le nom MySource. Le paramètre SourceLocation spécifie l’adresse du dépôt.

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 Repository spécifie la recherche dans 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 a quatre fonctionnalités prédéfinies qui sont utilisées pour rechercher dans le référentiel. Utilisez tab-complete 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 Repository pour effectuer une recherche dans le dépôt , 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 effectuer une recherche dans le dépôt.

Pour un dépôt basé sur NuGet, le paramètre Filter recherche l’argument dans le nom, la description et les balises.

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 AppDomain dans le référentiel.

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 une préversion.

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

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

-Command

Spécifie un tableau de commandes à rechercher dans les modules. Une commande peut être une fonction ou un workflow.

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

-Credential

Spécifie un compte d’utilisateur qui dispose des droits d’installation d’un module pour un fournisseur ou une source de package spécifié.

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

-DscResource

Spécifie le nom, ou une partie du nom, des modules qui contiennent des ressources DSC. Conformément aux conventions PowerShell, effectue une recherche OR lorsque vous fournissez plusieurs arguments.

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

-Filter

Spécifie un filtre basé sur la syntaxe de recherche propre au fournisseur PackageManagement . Pour les modules NuGet, ce paramètre équivaut à effectuer une recherche à l’aide de la barre de recherche sur le site web PowerShell Gallery.

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

-IncludeDependencies

Indique que cette opération inclut tous les modules qui dépendent du module spécifié dans le paramètre Name .

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

-Includes

Retourne uniquement les modules qui incluent des types spécifiques de fonctionnalités PowerShell. Par exemple, vous souhaiterez peut-être rechercher uniquement des modules qui incluent DSCResource. Les valeurs acceptables pour ce paramètre sont les suivantes :

Applet de commande
DscResource
Fonction
RoleCapability

Type:	String[]
Accepted values:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

Spécifie la version maximale ou la plus récente du module à inclure dans les résultats de la recherche. MaximumVersion et RequiredVersion ne peuvent pas être utilisés dans la même commande.

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

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

-Name

Spécifie les noms des modules à rechercher dans le référentiel. Une liste de noms de module séparés par des virgules est acceptée. Les caractères génériques sont acceptés.

Type:	String[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-Proxy

Spécifie un serveur proxy pour la requête, plutôt que de se connecter directement à la ressource Internet.

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

-Repository

Utilisez le paramètre Repository pour spécifier le référentiel à rechercher pour un module. Utilisé lorsque plusieurs référentiels sont inscrits. Accepte une liste de dépôts séparés par des virgules. Pour inscrire un dépôt, utilisez Register-PSRepository. Pour afficher les dépôts inscrits, utilisez Get-PSRepository.

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

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

-Tag

Spécifie un tableau de balises. Les exemples de balises incluent DesiredStateConfiguration, DSC, DSCResourceKit ou PSModule.

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

Entrées

String[]

String

Uri

PSCredential

Sorties

PSRepositoryItemInfo

Find-Module crée des objets PSRepositoryItemInfo qui peuvent être envoyés dans le pipeline à des 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 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.

Partager via

Find-Module

Syntax

Description

Exemples

Exemple 1 : Rechercher un module par son nom

Exemple 2 : Rechercher des modules avec des noms similaires

Exemple 3 : Rechercher un module par version minimale

Exemple 4 : Rechercher un module par version spécifique

Exemple 5 : Rechercher un module dans un référentiel spécifique

Exemple 6 : Rechercher un module dans plusieurs dépôts

Exemple 7 : Rechercher un module qui contient une ressource DSC

Exemple 8 : Rechercher un module avec un filtre

Exemple 9 : Rechercher un module par balise

Paramètres

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Entrées

Sorties

Notes

Ressources supplémentaires

Partager via

Find-Module

Syntax

Description

Exemples

Exemple 1 : Rechercher un module par son nom

Exemple 2 : Rechercher des modules avec des noms similaires

Exemple 3 : Rechercher un module par version minimale

Exemple 4 : Rechercher un module par version spécifique

Exemple 5 : Rechercher un module dans un référentiel spécifique

Exemple 6 : Rechercher un module dans plusieurs dépôts

Exemple 7 : Rechercher un module qui contient une ressource DSC

Exemple 8 : Rechercher un module avec un filtre

Exemple 9 : Rechercher un module par balise

Paramètres

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Entrées

Sorties

Notes

Liens associés

Ressources supplémentaires