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.

Il s’agit d’une applet de commande de proxy pour l’applet Find-PSResource de commande dans Microsoft.PowerShell.PSResourceGet. Pour plus d’informations, consultez Find-PSResource.

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.

L’applet de commande proxy mappe ce paramètre au paramètre Prerelease de Find-PSResource.

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 .

L’applet de commande proxy transforme ce paramètre en avant d’appeler -Version *Find-PSResource.

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

-Command

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par nameParameterSet de Find-PSResource.

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

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par nameParameterSet de Find-PSResource.

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

-Filter

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par nameParameterSet de Find-PSResource.

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

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par nameParameterSet de Find-PSResource.

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

-MaximumVersion

L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Find-PSResource.

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

-MinimumVersion

L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Find-PSResource.

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

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par nameParameterSet de Find-PSResource.

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

-ProxyCredential

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par nameParameterSet de Find-PSResource.

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

L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Find-PSResource.

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

-RoleCapability

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par nameParameterSet de Find-PSResource.

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

Le PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Vous devez utiliser TLS 1.2 ou version ultérieure. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

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