Find-Module

Módulo:

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

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

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	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 .

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

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

-Command

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	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 del parámetro

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

Conjuntos de parámetros

(All)

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

-DscResource

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

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

-Filter

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	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 del parámetro

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

Conjuntos de parámetros

(All)

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

-Includes

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

Propiedades del 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
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-MaximumVersion

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

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

-MinimumVersion

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	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 del parámetro

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

Conjuntos de parámetros

(All)

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

-Proxy

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

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

-ProxyCredential

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	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 del parámetro

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

Conjuntos de parámetros

(All)

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

-RequiredVersion

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

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

-RoleCapability

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	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 del parámetro

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

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	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

La 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 comando siguiente para asegurarse de que usa TLS 1.2:

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

Vínculos relacionados

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