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

La primera vez Find-Module que intenta usar un repositorio, es posible que se le pida que instale las actualizaciones. Si el origen del repositorio no está registrado con Register-PSRepository el cmdlet , se devuelve un error.

Find-Module devuelve la versión más reciente de un módulo si no se usa ningún parámetro que limite la versión. Para obtener la lista de un repositorio de las versiones de un módulo, use el parámetro AllVersions.

Si se especifica el parámetro MinimumVersion , Find-Module devuelve la versión del módulo que es igual o mayor que el mínimo. Si hay una versión más reciente disponible en el repositorio, se devuelve la versión más reciente.

Si se especifica el parámetro MaximumVersion , Find-Module devuelve la versión más reciente del módulo que no supera la versión especificada.

Si se especifica el parámetro RequiredVersion , Find-Module solo devuelve la versión del módulo que es una coincidencia exacta con la versión especificada. Find-Module busca en todos los módulos disponibles, ya que pueden producirse conflictos de nombres entre orígenes.

Los parámetros que toman números de versión del módulo esperan cadenas con formato de números de versión.

Los números de versión estándar tienen un formato de x.y.z donde x, y y z son números.
Las versiones preliminares tienen un formato de x.y.z-<prerelease_label> donde la <prerelease_label> cadena arbitraria está asignada a esa versión.

En los ejemplos siguientes se usa el Galería de PowerShell como único repositorio registrado. Get-PSRepository muestra los repositorios registrados. Si tiene varios repositorios registrados, use el -Repository parámetro para especificar el nombre del repositorio.

Ejemplos

Ejemplo 1: Buscar un módulo por nombre

En este ejemplo se busca 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 Register-PSRepository para 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: Búsqueda de 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 mediante 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 versión preliminar.

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 .

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

-Command

Especifica una matriz de comandos que se van a buscar en los módulos. Un comando puede ser una función o un flujo de trabajo.

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

Especifica el nombre, o parte del nombre, de los módulos que contienen recursos de DSC. Por convenciones de PowerShell, realiza una búsqueda OR al proporcionar varios argumentos.

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

-Filter

Especifica un filtro basado en la sintaxis de búsqueda específica del proveedor PackageManagement . En el caso de los módulos NuGet, este parámetro es el equivalente a buscar mediante la barra de búsqueda del sitio web de Galería de PowerShell.

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

Devuelve solo los módulos que incluyen tipos específicos de funcionalidad de PowerShell. Por ejemplo, es posible que solo quiera buscar módulos que incluyan DSCResource. Los valores aceptables para este parámetro son los siguientes:

Cmdlet
DscResource
Función
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

Especifica la versión máxima o más reciente del módulo que se va a incluir en los resultados de búsqueda. MaximumVersion y RequiredVersion no se pueden usar en el mismo comando.

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

-MinimumVersion

Especifica la versión mínima del módulo que se va a incluir en los resultados. MinimumVersion y RequiredVersion no se pueden usar en el mismo comando.

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

Especifica un servidor proxy para la solicitud, en lugar de conectarse directamente al recurso de Internet.

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

-ProxyCredential

Especifica una cuenta de usuario que tiene permiso para usar el servidor proxy especificado por el parámetro Proxy.

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

Especifica el número de versión exacto del módulo que se va a incluir en los resultados. RequiredVersion no se puede usar en el mismo comando que MinimumVersion o MaximumVersion.

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

-RoleCapability

Especifica una matriz de funcionalidades de rol.

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

Importante

A partir de abril de 2020, Galería de PowerShell ya no es compatible con las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o una versión posterior, recibirá un error al intentar obtener acceso a Galería de PowerShell. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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

Para más información, consulte el anuncio en el blog de PowerShell.

Compartir a través de

Find-Module

Syntax

Description

Ejemplos

Ejemplo 1: Buscar un módulo por nombre

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

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

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

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

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

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

Ejemplo 8: Búsqueda de un módulo con un filtro

Ejemplo 9: Buscar un módulo por etiqueta

Parámetros

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Entradas

Salidas

Notas

Recursos adicionales

Compartir a través de

Find-Module

Syntax

Description

Ejemplos

Ejemplo 1: Buscar un módulo por nombre

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

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

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

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

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

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

Ejemplo 8: Búsqueda de un módulo con un filtro

Ejemplo 9: Buscar un módulo por etiqueta

Parámetros

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Entradas

Salidas

Notas

Vínculos relacionados

Recursos adicionales