Find-Module

Módulo:

PowerShellGet Module

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

Sintaxis

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

El Find-Module cmdlet busca módulos en un repositorio que coincida 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 la Galería de PowerShell como único repositorio registrado. Get-PSRepository muestra los repositorios registrados. Si tiene varios repositorios registrados, use el parámetro para especificar el -Repository 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: Buscar 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: Buscar 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 reciente.

Ejemplo 4: Buscar 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 que se va a 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 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 tabulación completa para mostrar las cuatro funcionalidades admitidas por 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.

En el caso de 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 una versión preliminar.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-AllVersions

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Command

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

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Credential

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

Propiedades de parámetro

Tipo:	PSCredential
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	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.

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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 en el sitio web de la Galería de PowerShell .

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-IncludeDependencies

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Valores aceptados:	DscResource, Cmdlet, Function, RoleCapability
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-MaximumVersion

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

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	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.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	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 comodines.

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	True
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	0
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-Proxy

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

Propiedades de parámetro

Tipo:	Uri
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-ProxyCredential

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

Propiedades de parámetro

Tipo:	PSCredential
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-Repository

Use el parámetro Repository para especificar qué repositorio buscar 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.

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-RoleCapability

Especifica una matriz de funcionalidades de rol.

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Tag

Especifica una matriz de etiquetas. Las etiquetas de ejemplo incluyen DesiredStateConfiguration, DSC, DSCResourceKit o PSModule.

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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, la Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o superior, recibirá un error al intentar acceder a la Galería de PowerShell. Use el comando siguiente para asegurarse de que usa TLS 1.2:

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

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

Vínculos relacionados

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