Find-Module
Localiza módulos em um repositório que correspondem aos critérios especificados.
Sintaxe
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
O Find-Module cmdlet localiza módulos em um repositório que correspondem aos critérios especificados.
Find-Module retorna um objeto PSRepositoryItemInfo para cada módulo encontrado. Os objetos podem ser enviados pelo pipeline para cmdlets como Install-Module.
Este é um cmdlet proxy para o Find-PSResource cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, consulte Find-PSResource.
Exemplos
Exemplo 1: localizar um módulo por nome
Este exemplo localiza um módulo no repositório padrão.
Find-Module -Name PowerShellGet
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...O Find-Module cmdlet usa o parâmetro Name para especificar o módulo PowerShellGet .
Exemplo 2: localizar módulos com nomes semelhantes
Este exemplo usa o curinga do asterisco (*) para localizar módulos com nomes semelhantes.
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 ISEO Find-Module cmdlet usa o parâmetro Name com o curinga asterisco (*) para localizar todos os módulos que contêm o PowerShell.
Exemplo 3: localizar um módulo por versão mínima
Este exemplo pesquisa a versão mínima de um módulo. Se o repositório contiver uma versão mais recente do módulo, a versão mais recente será retornada.
Find-Module -Name PowerShellGet -MinimumVersion 1.6.5
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...O Find-Module cmdlet usa o parâmetro Name para especificar o módulo PowerShellGet . O MinimumVersion especifica a versão 1.6.5.
Find-Module retorna o PowerShellGet versão 2.1.0 porque excede a versão mínima e é a versão mais atual.
Exemplo 4: localizar um módulo por versão específica
Este exemplo mostra como instalar uma versão de pré-lançamento específica de um módulo. As versões de pré-lançamento têm um 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…Exemplo 5: localizar um módulo em um repositório específico
Este exemplo usa o parâmetro Repositório para localizar um módulo em um repositório específico.
Find-Module -Name PowerShellGet -Repository PSGallery
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...O Find-Module cmdlet usa o parâmetro Name para especificar o módulo PowerShellGet . O parâmetro repositório especifica para pesquisar o repositório PSGallery .
Exemplo 6: localizar um módulo em vários repositórios
Este exemplo usa o Register-PSRepository para especificar um repositório.
Find-Module usa o repositório para pesquisar um 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...O Register-PSRepository cmdlet registra um novo repositório. O parâmetro Name atribui o nome MySource. O parâmetro SourceLocation especifica o endereço do repositório.
O Find-Module cmdlet usa o parâmetro Name com o curinga asterisco (*) para especificar o módulo Contoso . O parâmetro repositório especifica a pesquisa de dois repositórios, PSGallery e MySource.
Exemplo 7: localizar um módulo que contém um recurso DSC
Esse comando retorna módulos que contêm recursos DSC. O parâmetro Includes tem quatro funcionalidades predefinidas que são usadas para pesquisar o repositório. Use a guia concluída para exibir as quatro funcionalidades compatíveis com o 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...O Find-Module cmdlet usa o parâmetro Repositório para pesquisar o repositório , PSGallery.
O parâmetro Includes especifica DscResource, que é uma funcionalidade que o parâmetro pode pesquisar no repositório.
Exemplo 8: localizar um módulo com um filtro
Neste exemplo, para localizar módulos, um filtro é usado para pesquisar o repositório.
Para um repositório baseado em NuGet, o parâmetro Filter pesquisa o nome, a descrição e as marcas do 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...O Find-Module cmdlet usa o parâmetro Filter para pesquisar o repositório para AppDomain.
Exemplo 9: Localizar um módulo por marca
Este exemplo mostra como localizar módulos por uma marca. O CrescendoBuilt valor é uma marca que é adicionada automaticamente aos módulos criados usando o 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
Inclui nos módulos de resultados marcados como uma pré-lançamento.
O cmdlet de proxy mapeia esse parâmetro para o parâmetro Prerelease de Find-PSResource.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AllVersions
Especifica para incluir todas as versões de um módulo nos resultados. Você não pode usar o parâmetro AllVersions com os parâmetrosMinimumVersion, MaximumVersion ou RequiredVersion .
O cmdlet de proxy transforma esse parâmetro para o antes de -Version * chamar Find-PSResource.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Command
O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Credential
Especifica uma conta de usuário que tem direitos para instalar um módulo para um provedor ou origem de pacote especificado.
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-DscResource
O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Filter
O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IncludeDependencies
Indica que essa operação inclui todos os módulos que dependem do módulo especificado no parâmetro Name .
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Includes
O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.
| Tipo: | String[] |
| Valores aceitos: | DscResource, Cmdlet, Function, RoleCapability |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MaximumVersion
O cmdlet de proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Find-PSResource.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-MinimumVersion
O cmdlet de proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Find-PSResource.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Name
Especifica os nomes dos módulos a serem pesquisados no repositório. Uma lista separada por vírgulas de nomes de módulo é aceita. Você pode usar curingas.
| Tipo: | String[] |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | True |
-Proxy
O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.
| Tipo: | Uri |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ProxyCredential
O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Repository
Use o parâmetro repositório para especificar qual repositório procurar um módulo. Usado quando vários repositórios são registrados. Aceita uma lista separada por vírgulas de repositórios. Para registrar um repositório, use Register-PSRepository. Para exibir repositórios registrados, use Get-PSRepository.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RequiredVersion
O cmdlet de proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Find-PSResource.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-RoleCapability
O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Tag
Especifica um array de tags. As marcas de exemplo incluem DesiredStateConfiguration, DSC, DSCResourceKit ou PSModule.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
String[]
Saídas
PSRepositoryItemInfo
Find-Module cria objetos PSRepositoryItemInfo que podem ser enviados pelo pipeline para cmdlets como Install-Module.
Observações
O PowerShell inclui os seguintes aliases para Find-Module:
- Todas as plataformas:
fimo
A Galeria do PowerShell não dá mais suporte a TLS (Transport Layer Security) versões 1.0 e 1.1. Você deve usar o TLS 1.2 ou superior. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
