Find-Module
Busca módulos en un repositorio que coincidan con los criterios especificados.
Sintaxis
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 ISEEl 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.exePará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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Command
El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Credential
Especifica una cuenta de usuario que tiene derechos para instalar un módulo para un proveedor de paquetes o un origen especificados.
| Tipo: | PSCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-DscResource
El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Filter
El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-IncludeDependencies
Indica que esta operación incluye todos los módulos que dependen del módulo especificado en el parámetro Name .
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Includes
El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.
| Tipo: | String[] |
| Valores aceptados: | DscResource, Cmdlet, Function, RoleCapability |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | String[] |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | True |
-Proxy
El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.
| Tipo: | Uri |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ProxyCredential
El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.
| Tipo: | PSCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-RoleCapability
El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Tag
Especifica una matriz de etiquetas. Las etiquetas de ejemplo incluyen DesiredStateConfiguration, DSC, DSCResourceKit o PSModule.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
String[]
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
