Find-Module

Module:

PowerShellGet 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 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

-AllowPrerelease

Inclut dans les modules de résultats marqués comme préversion.

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

-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

-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 du paramètre

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 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:	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 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é:	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:	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 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:	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 du paramètre

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 du paramètre

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 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:	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 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

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

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

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.

Liens associés

• Get-PSRepository
• Install-Module
• Publish-Module
• Save-Module
• Uninstall-Module
• Update-Module
• Register-PSRepository