Find-Module
Localiza módulos num repositório que correspondem a critérios especificados.
Syntax
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 num repositório que correspondem aos critérios especificados.
Find-Module devolve um objeto PSRepositoryItemInfo para cada módulo que encontrar. 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, veja Find-PSResource.
Exemplos
Exemplo 1: localizar um módulo por nome
Este exemplo localiza um módulo no repositório predefinido.
Find-Module -Name PowerShellGet
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...O Find-Module cmdlet utiliza o parâmetro Name para especificar o módulo PowerShellGet .
Exemplo 2: localizar módulos com nomes semelhantes
Este exemplo utiliza o caráter universal 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 utiliza o parâmetro Name com o caráter universal 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 procura a versão mínima de um módulo. Se o repositório contiver uma versão mais recente do módulo, será devolvida a versão mais recente.
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 utiliza o parâmetro Name para especificar o módulo PowerShellGet . MinimumVersion especifica a versão 1.6.5. Find-Module devolve a versão 2.1.0 do PowerShellGet 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 num repositório específico
Este exemplo utiliza o parâmetro Repositório para localizar um módulo num 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 utiliza o parâmetro Name para especificar o módulo PowerShellGet . O parâmetro Repository especifica para procurar no repositório PSGallery .
Exemplo 6: localizar um módulo em vários repositórios
Este exemplo utiliza o Register-PSRepository para especificar um repositório. Find-Module utiliza o repositório para procurar 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 regista 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 utiliza o parâmetro Name com o caráter universal asterisco (*) para especificar o módulo Contoso . O parâmetro Repository especifica para procurar dois repositórios, PSGallery e MySource.
Exemplo 7: localizar um módulo que contenha um recurso do DSC
Este comando devolve módulos que contêm recursos do DSC. O parâmetro Inclui tem quatro funcionalidades predefinidas que são utilizadas para pesquisar o repositório. Utilize a tecla tab-complete para apresentar as quatro funcionalidades suportadas pelo parâmetro Inclui .
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 utiliza o parâmetro Repository para pesquisar o repositório PSGallery.
O parâmetro Includes especifica DscResource, que é uma funcionalidade que o parâmetro pode procurar no repositório.
Exemplo 8: localizar um módulo com um filtro
Neste exemplo, para localizar módulos, é utilizado um filtro para procurar no repositório.
Para um repositório baseado em NuGet, o parâmetro Filter procura o nome, a descrição e as etiquetas 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 utiliza o parâmetro Filter para procurar AppDomain no repositório.
Exemplo 9: localizar um módulo por etiqueta
Este exemplo mostra como localizar módulos por uma etiqueta. O CrescendoBuilt valor é uma etiqueta que é adicionada automaticamente aos módulos criados com 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 pré-lançamento.
O cmdlet proxy mapeia este parâmetro para o parâmetro Prerelease de Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
Especifica para incluir todas as versões de um módulo nos resultados. Não pode utilizar o parâmetro AllVersions com os parâmetrosMinimumVersion, MaximumVersion ou RequiredVersion .
O cmdlet proxy transforma este parâmetro no -Version * antes de chamar Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Command
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo NameParameterSet de Find-PSResource.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Especifica uma conta de utilizador que tem direitos para instalar um módulo para um fornecedor ou origem de pacote especificado.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DscResource
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo NameParameterSet de Find-PSResource.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo NameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeDependencies
Indica que esta operação inclui todos os módulos dependentes do módulo especificado no parâmetro Nome .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Includes
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo NameParameterSet de Find-PSResource.
| Type: | String[] |
| Accepted values: | DscResource, Cmdlet, Function, RoleCapability |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
O cmdlet proxy utiliza o valor deste parâmetro para criar uma cadeia de pesquisa de versão NuGet para utilização com o parâmetro Versão de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MinimumVersion
O cmdlet proxy utiliza o valor deste parâmetro para criar uma cadeia de pesquisa de versão NuGet para utilização com o parâmetro Versão de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica os nomes dos módulos a procurar no repositório. É aceite uma lista separada por vírgulas de nomes de módulos. Os carateres universais são aceites.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Proxy
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo NameParameterSet de Find-PSResource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo NameParameterSet de Find-PSResource.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
Utilize o parâmetro Repositório para especificar o repositório para procurar um módulo. Utilizado quando são registados vários repositórios. Aceita uma lista separada por vírgulas de repositórios. Para registar um repositório, utilize Register-PSRepository. Para apresentar repositórios registados, utilize Get-PSRepository.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
O cmdlet proxy utiliza o valor deste parâmetro para criar uma cadeia de pesquisa de versão NuGet para utilização com o parâmetro Versão de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RoleCapability
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo NameParameterSet de Find-PSResource.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
Especifica uma matriz de etiquetas. As etiquetas de exemplo incluem DesiredStateConfiguration, DSC, DSCResourceKit ou PSModule.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
String[]
Saídas
PSRepositoryItemInfo
Find-Module cria objetos PSRepositoryItemInfo que podem ser enviados pelo pipeline para cmdlets como Install-Module.
Notas
O PowerShell inclui os seguintes aliases para Find-Module:
- Todas as plataformas:
fimo
O Galeria do PowerShell já não suporta as versões 1.0 e 1.1 do Transport Layer Security (TLS). Tem de utilizar o TLS 1.2 ou superior. Utilize o seguinte comando para garantir que está a utilizar o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
