Find-Module
Localiza módulos em um repositório que correspondem aos critérios especificados.
Sintaxe
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
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.
Na primeira vez Find-Module que tenta usar um repositório, você pode ser solicitado a instalar atualizações.
Se a origem do repositório não estiver registrada com Register-PSRepository o cmdlet, um erro será retornado.
Find-Module retornará a versão mais recente de um módulo se nenhum parâmetro for usado que limite a versão. Para obter a lista de versões de um módulo de um repositório, use o parâmetro AllVersions.
Se o parâmetro MinimumVersion for especificado, Find-Module retornará a versão do módulo igual ou maior que o mínimo. Se houver uma versão mais recente disponível no repositório, a versão mais recente será retornada.
Se o parâmetro MaximumVersion for especificado, Find-Module retornará a versão mais recente do módulo que não excede a versão especificada.
Se o parâmetro RequiredVersion for especificado, Find-Module retornará apenas a versão do módulo que é uma correspondência exata com a versão especificada.
Find-Module pesquisa em todos os módulos disponíveis, porque conflitos de nome entre fontes podem ocorrer.
Os exemplos a seguir usam a Galeria do PowerShell como o único repositório registrado.
Get-PSRepository exibe os repositórios registrados. Se você tiver vários repositórios registrados, use o -Repository parâmetro para especificar o nome do repositório.
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 ISE
O 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 retorna um objeto que representa a versão específica de um módulo. Se a versão especificada não for encontrada, um erro será retornado.
Find-Module -Name PowerShellGet -RequiredVersion 1.6.5
Version Name Repository Description
------- ---- ---------- -----------
1.6.5 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 RequiredVersion especifica a versão 1.6.5.
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.
Parâmetros
-AllowPrerelease
Inclui nos módulos de resultados marcados como uma pré-lançamento.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 .
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Command
Especifica uma matriz de comandos a serem encontrados em módulos. Um comando pode ser uma função ou um fluxo de trabalho.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Credential
Especifica uma conta de usuário que tem direitos para instalar um módulo para um provedor ou origem de pacote especificado.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-DscResource
Especifica o nome ou parte do nome de módulos que contêm recursos DSC. Por convenções do PowerShell, executa uma pesquisa OR quando você fornece vários argumentos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Filter
Especifica um filtro com base na sintaxe de pesquisa específica do provedor PackageManagement . Para módulos NuGet, esse parâmetro é o equivalente a pesquisar usando a barra de pesquisa no site da Galeria do PowerShell .
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncludeDependencies
Indica que essa operação inclui todos os módulos que dependem do módulo especificado no parâmetro Name .
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Includes
Retorna apenas os módulos que incluem tipos específicos de funcionalidade do PowerShell. Por exemplo, talvez você queira encontrar apenas módulos que incluam DSCResource. Os valores aceitáveis para esse parâmetro são os seguintes:
- Cmdlet
- DscResource
- Função
- FunçãoCapacidade
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Valores aceitos: | DscResource, Cmdlet, Function, RoleCapability |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MaximumVersion
Especifica a versão máxima ou mais recente do módulo a ser incluída nos resultados da pesquisa. MaximumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-MinimumVersion
Especifica a versão mínima do módulo a ser incluída nos resultados. MinimumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Proxy
Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente ao recurso da Internet.
Propriedades do parâmetro
| Tipo: | Uri |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ProxyCredential
Especifica uma conta de usuário que tem permissão para usar o servidor proxy especificado pelo parâmetro Proxy .
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RequiredVersion
Especifica o número exato da versão do módulo a ser incluído nos resultados. RequiredVersion não pode ser usado no mesmo comando que MinimumVersion ou MaximumVersion.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-RoleCapability
Especifica uma matriz de recursos de função.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Tag
Especifica um array de tags. As marcas de exemplo incluem DesiredStateConfiguration, DSC, DSCResourceKit ou PSModule.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
String
String
Uri
PSCredential
Saídas
PSRepositoryItemInfo
Find-Module cria objetos PSRepositoryItemInfo que podem ser enviados pelo pipeline para cmdlets como Install-Module.
Observações
Importante
A partir de abril de 2020, a Galeria do PowerShell não dá mais suporte ao TLS (Transport Layer Security) versões 1.0 e 1.1. Se você não estiver usando o TLS 1.2 ou superior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Para obter mais informações, consulte o comunicado no blog do PowerShell.