Compartir a través de

Find-Module

  • Referencia
Módulo:
PowerShellGet

Busca módulos en un repositorio que coincidan con los criterios especificados.

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

El Find-Module cmdlet busca módulos en un repositorio que coinciden con los criterios especificados. Find-Module devuelve un objeto PSRepositoryItemInfo para cada módulo que encuentra. Los objetos se pueden enviar por la canalización a cmdlets como Install-Module.

Se trata de un cmdlet de proxy para el Find-PSResource cmdlet en Microsoft.PowerShell.PSResourceGet. Para obtener más información, consulte Find-PSResource.

Ejemplos

Ejemplo 1: Buscar un módulo por nombre

En este ejemplo se encuentra un módulo en el repositorio predeterminado.

Find-Module -Name PowerShellGet

Version   Name              Repository           Description
-------   ----              ----------           -----------
2.1.0     PowerShellGet     PSGallery            PowerShell module with commands for discovering...

El Find-Module cmdlet usa el parámetro Name para especificar el módulo PowerShellGet .

Ejemplo 2: Búsqueda de módulos con nombres similares

En este ejemplo se usa el carácter comodín asterisco (*) para buscar módulos con nombres similares.

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

El Find-Module cmdlet usa el parámetro Name con el carácter comodín asterisco (*) para buscar todos los módulos que contienen PowerShell.

Ejemplo 3: Búsqueda de un módulo por versión mínima

En este ejemplo se busca la versión mínima de un módulo. Si el repositorio contiene una versión más reciente del módulo, se devuelve la versión más reciente.

Find-Module -Name PowerShellGet -MinimumVersion 1.6.5

Version   Name             Repository     Description
-------   ----             ----------     -----------
2.1.0     PowerShellGet    PSGallery      PowerShell module with commands for discovering...

El Find-Module cmdlet usa el parámetro Name para especificar el módulo PowerShellGet . MinimumVersion especifica la versión 1.6.5. Find-Module devuelve PowerShellGet versión 2.1.0 porque supera la versión mínima y es la versión más actual.

Ejemplo 4: Búsqueda de un módulo por versión específica

En este ejemplo se muestra cómo instalar una versión preliminar específica de un módulo. Las versiones preliminares tienen un formato 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…

Ejemplo 5: Buscar un módulo en un repositorio específico

En este ejemplo se usa el parámetro Repository para buscar un módulo en un repositorio específico.

Find-Module -Name PowerShellGet -Repository PSGallery

Version   Name             Repository     Description
-------   ----             ----------     -----------
2.1.0     PowerShellGet    PSGallery      PowerShell module with commands for discovering...

El Find-Module cmdlet usa el parámetro Name para especificar el módulo PowerShellGet . El parámetro Repository especifica para buscar en el repositorio PSGallery .

Ejemplo 6: Búsqueda de un módulo en varios repositorios

En este ejemplo se usa para Register-PSRepository especificar un repositorio. Find-Module usa el repositorio para buscar un módulo.

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

El Register-PSRepository cmdlet registra un nuevo repositorio. El parámetro Name asigna el nombre MySource. El parámetro SourceLocation especifica la dirección del repositorio.

El Find-Module cmdlet usa el parámetro Name con el carácter comodín asterisco (*) para especificar el módulo Contoso . El parámetro Repository especifica para buscar dos repositorios, PSGallery y MySource.

Ejemplo 7: Búsqueda de un módulo que contiene un recurso de DSC

Este comando devuelve módulos que contienen recursos de DSC. El parámetro Includes tiene cuatro funcionalidades predefinidas que se usan para buscar en el repositorio. Use tab-complete para mostrar las cuatro funcionalidades compatibles con el parámetro 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...

El Find-Module cmdlet usa el parámetro Repository para buscar en el repositorio, PSGallery. El parámetro Includes especifica DscResource, que es una funcionalidad que el parámetro puede buscar en el repositorio.

Ejemplo 8: Buscar un módulo con un filtro

En este ejemplo, para buscar módulos, se usa un filtro para buscar en el repositorio.

Para un repositorio basado en NuGet, el parámetro Filter busca el nombre, la descripción y las etiquetas del argumento.

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

El Find-Module cmdlet usa el parámetro Filter para buscar el repositorio de AppDomain.

Ejemplo 9: Buscar un módulo por etiqueta

En este ejemplo se muestra cómo buscar módulos por una etiqueta. El CrescendoBuilt valor es una etiqueta que se agrega automáticamente a los módulos creados mediante el módulo 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

Parámetros

-AllowPrerelease

Incluye en los módulos de resultados marcados como una versión preliminar.

El cmdlet de proxy asigna este parámetro al parámetro Versión preliminar de Find-PSResource.

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

-AllVersions

Especifica que se incluirán todas las versiones de un módulo en los resultados. No se puede usar el parámetro AllVersions con los parámetros MinimumVersion, MaximumVersion o RequiredVersion .

El cmdlet de proxy transforma este parámetro en antes -Version * de llamar a Find-PSResource.

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

-Command

El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.

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

-Credential

Especifica una cuenta de usuario que tiene derechos para instalar un módulo para un proveedor de paquetes o un origen especificados.

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

-DscResource

El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.

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

-Filter

El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.

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

-IncludeDependencies

Indica que esta operación incluye todos los módulos que dependen del módulo especificado en el parámetro Name .

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

-Includes

El cmdlet de proxy omite este parámetro, ya que no es compatible con 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

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet para usarla con el parámetro Version de Find-PSResource.

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

-MinimumVersion

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet para usarla con el parámetro Version de Find-PSResource.

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

-Name

Especifica los nombres de los módulos que se van a buscar en el repositorio. Se acepta una lista separada por comas de nombres de módulo. Se aceptan caracteres comodín.

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

-Proxy

El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.

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

-ProxyCredential

El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.

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

-Repository

Use el parámetro Repository para especificar el repositorio que se va a buscar en un módulo. Se usa cuando se registran varios repositorios. Acepta una lista separada por comas de repositorios. Para registrar un repositorio, use Register-PSRepository. Para mostrar repositorios registrados, use Get-PSRepository.

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

-RequiredVersion

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet para usarla con el parámetro Version de Find-PSResource.

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

-RoleCapability

El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.

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

-Tag

Especifica una matriz de etiquetas. Entre las etiquetas de ejemplo se incluyen DesiredStateConfiguration, DSC, DSCResourceKit o PSModule.

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

Entradas

String[]

String

Uri

PSCredential

Salidas

PSRepositoryItemInfo

Find-Module crea objetos PSRepositoryItemInfo que se pueden enviar por la canalización a cmdlets como Install-Module.

Notas

PowerShell incluye los siguientes alias para Find-Module:

  • Todas las plataformas:
    • fimo

El Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Debe usar TLS 1.2 o superior. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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