Find-Module

Módulo:: PowerShellGet 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 tentar usar um repositório, você poderá ser solicitado a instalar atualizações. Se a origem do repositório não estiver registrada no Register-PSRepository cmdlet, um erro será retornado.

Find-Module Retorna 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 corresponde exatamente à versão especificada. Find-Module pesquisa em todos os módulos disponíveis, porque podem ocorrer conflitos de nome entre fontes.

Os parâmetros que usam números de versão do módulo esperam cadeias de caracteres formatadas como números de versão.

Os números de versão padrão têm um formato em x.y.z que x, y e z são números
As versões de pré-lançamento têm um formato em que a x.y.z-<prerelease_label> cadeia de <prerelease_label> caracteres é arbitrária atribuída a essa versão.

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: Encontrar módulos com nomes semelhantes

Este exemplo usa o curinga 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 procura 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 num repositório específico

Este exemplo usa o parâmetro Repository 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 Repository 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 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 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 Repository especifica para pesquisar dois repositórios, PSGallery e MySource.

Exemplo 7: Localizar um módulo que contém um recurso DSC

Este 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 tab-complete para exibir as quatro funcionalidades suportadas pelo 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 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, 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 tags para o 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 AppDomain no repositório.

Exemplo 9: Localizar um módulo por tag

Este exemplo mostra como localizar módulos por uma tag. 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.exe

Parâmetros

-AllowPrerelease

Inclui nos resultados módulos marcados como pré-lançamento.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-AllVersions

Especifica para incluir todas as versões de um módulo nos resultados. Não é possível usar o parâmetro AllVersions com os parâmetros MinimumVersion, MaximumVersion ou RequiredVersion .

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Command

Especifica uma matriz de comandos para localizar em módulos. Um comando pode ser uma função ou fluxo de trabalho.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Credential

Especifica uma conta de usuário que tem direitos para instalar um módulo para um provedor de pacote especificado ou fonte.

Propriedades dos parâmetros

Tipo:	PSCredential
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-DscResource

Especifica o nome, ou parte do nome, dos módulos que contêm recursos DSC. Por convenções do PowerShell, executa uma pesquisa OU quando você fornece vários argumentos.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 à pesquisa usando a barra de pesquisa no site da Galeria do PowerShell .

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-IncludeDependencies

Indica que esta operação inclui todos os módulos que dependem do módulo especificado no parâmetro Name .

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 este parâmetro são os seguintes:

Cmdlet
DscResource
Função
RoleCapability

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Valores aceites:	DscResource, Cmdlet, Function, RoleCapability
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	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 dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Name

Especifica os nomes dos módulos a serem pesquisados no repositório. Uma lista separada por vírgulas de nomes de módulos é aceita. Curingas são aceitos.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	True
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	0
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Proxy

Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente ao recurso da Internet.

Propriedades dos parâmetros

Tipo:	Uri
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-ProxyCredential

Especifica uma conta de usuário que tem permissão para usar o servidor proxy especificado pelo parâmetro Proxy .

Propriedades dos parâmetros

Tipo:	PSCredential
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Repository

Use o parâmetro Repository para especificar qual repositório procurar um módulo. Usado quando vários repositórios são registrados. Aceita uma lista de repositórios separados por vírgula. Para registrar um repositório, use Register-PSRepository. Para exibir repositórios registrados, use Get-PSRepository.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-RoleCapability

Especifica uma matriz de recursos de função.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Tag

Especifica uma matriz de tags. Exemplos de tags incluem DesiredStateConfiguration, DSC, DSCResourceKit ou PSModule.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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

Uri

PSCredential

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

Importante

A partir de abril de 2020, a Galeria do PowerShell não suporta mais as versões 1.0 e 1.1 do Transport Layer Security (TLS). 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 de anúncio de no blog do PowerShell.

Feedback

Esta página foi útil?

Partilhar via

Find-Module

Sintaxe

All

Description

Exemplos

Exemplo 1: Localizar um módulo por nome

Exemplo 2: Encontrar módulos com nomes semelhantes

Exemplo 3: Localizar um módulo por versão mínima

Exemplo 4: Localizar um módulo por versão específica

Exemplo 5: Localizar um módulo num repositório específico

Exemplo 6: Localizar um módulo em vários repositórios

Exemplo 7: Localizar um módulo que contém um recurso DSC

Exemplo 8: Localizar um módulo com um filtro

Exemplo 9: Localizar um módulo por tag

Parâmetros

-AllowPrerelease

Propriedades dos parâmetros

Conjuntos de parâmetros

-AllVersions

Propriedades dos parâmetros

Conjuntos de parâmetros

-Command

Propriedades dos parâmetros

Conjuntos de parâmetros

-Credential

Propriedades dos parâmetros

Conjuntos de parâmetros

-DscResource

Propriedades dos parâmetros

Conjuntos de parâmetros

-Filter

Propriedades dos parâmetros

Conjuntos de parâmetros

-IncludeDependencies

Propriedades dos parâmetros

Conjuntos de parâmetros

-Includes

Propriedades dos parâmetros

Conjuntos de parâmetros

-MaximumVersion

Propriedades dos parâmetros

Conjuntos de parâmetros

-MinimumVersion

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

Propriedades dos parâmetros

Conjuntos de parâmetros

-Proxy

Propriedades dos parâmetros

Conjuntos de parâmetros

-ProxyCredential

Propriedades dos parâmetros

Conjuntos de parâmetros

-Repository

Propriedades dos parâmetros

Conjuntos de parâmetros

-RequiredVersion

Propriedades dos parâmetros

Conjuntos de parâmetros

-RoleCapability

Propriedades dos parâmetros

Conjuntos de parâmetros

-Tag

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

String

String

Uri

PSCredential

Saídas

PSRepositoryItemInfo

Notas

Ligações Relacionadas

Feedback