Compartilhar via

Find-Command

  • Referência
Módulo:
PowerShellGet

Localiza comandos do PowerShell em módulos.

Syntax

Find-Command
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Description

O Find-Command cmdlet localiza comandos do PowerShell, como cmdlets, aliases, funções e fluxos de trabalho. Find-Command pesquisa módulos em repositórios registrados.

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 comando por nome

Find-Command pode usar o nome de um comando para localizar o módulo em um repositório. É possível que exista um nome de comando em vários ModuleNames.

Find-Command -Repository PSGallery -Name Get-TargetResource

Name                  Version    ModuleName                      Repository
----                  -------    ----------                      ----------
Get-TargetResource    3.1.0.0    xPowerShellExecutionPolicy      PSGallery
Get-TargetResource    1.0.0      xInternetExplorerHomePage       PSGallery
Get-TargetResource    1.2.0.0    SystemLocaleDsc                 PSGallery

Find-Command usa o parâmetro Repository para pesquisar o PSGallery. O parâmetro Name especifica o comando Get-TargetResource.

Exemplo 2: localizar comandos por nome e instalar o módulo

Find-Command pode localizar o comando e o módulo e, em seguida, enviar o objeto para Install-Module. Se um comando estiver incluído em vários módulos, use o parâmetro ModuleName dos Find-Command cmdlets. Caso contrário, os módulos poderão ser instalados que você não queria instalar.

Find-Command -Name Get-TargetResource -Repository PSGallery -ModuleName SystemLocaleDsc |
    Install-Module
Get-InstalledModule

Version   Name               Repository   Description
-------   ----               ----------   -----------
1.2.0.0   SystemLocaleDsc    PSGallery    This DSC Resource allows configuration of the Windows...

Find-Command usa o parâmetro Name para especificar o comando Get-TargetResource. O parâmetro Repository pesquisa o PSGallery. O parâmetro ModuleName especifica o módulo que você deseja instalar, SystemLocaleDsc. O objeto é enviado pelo pipeline para Install-Module e o módulo é instalado. Após a conclusão da instalação, você pode usar Get-InstalledModule para exibir os resultados.

Exemplo 3: localizar um comando e salvar seu módulo

Find-Command -Name Invoke-ScriptAnalyzer -Repository PSGallery |
    Save-Module -Path C:\Test\Modules -Verbose

VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'PSScriptAnalyzer'.
VERBOSE: Module 'PSScriptAnalyzer' was saved successfully to path 'C:\Test\Modules\PSScriptAnalyzer\1.18.0'.

Find-Command usa os parâmetros Name e Repository para pesquisar o comando Invoke-ScriptAnalyzer no repositório PSGallery . O objeto é enviado pelo pipeline para Save-Module. O parâmetro Path determina o local para salvar o módulo. Detalhado é um parâmetro opcional, mas exibe status saída no console do PowerShell. A saída detalhada é benéfica para a solução de problemas.

Parâmetros

-AllowPrerelease

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

O cmdlet proxy mapeia esse 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

O cmdlet de proxy ignora esse parâmetro, pois não tem suporte do CommandNameParameterSet de Find-PSResource.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

O cmdlet de proxy ignora esse parâmetro, pois não tem suporte do CommandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

O cmdlet de proxy ignora esse parâmetro, pois não tem suporte do CommandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

O cmdlet de proxy ignora esse parâmetro, pois não tem suporte do CommandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

O cmdlet de proxy ignora esse parâmetro, pois não tem suporte do CommandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome do comando a ser pesquisado em um repositório. Use vírgulas para separar uma matriz de nomes de comando.

O cmdlet proxy mapeia esse parâmetro para o parâmetro CommandName de Find-PSResource.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

O cmdlet de proxy ignora esse parâmetro, pois não tem suporte do CommandNameParameterSet de Find-PSResource.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

O cmdlet de proxy ignora esse parâmetro, pois não tem suporte do CommandNameParameterSet de Find-PSResource.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Repository

Especifica o repositório para pesquisar comandos. Use vírgulas para separar uma matriz de nomes de repositório. O padrão é todos os repositórios.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

O cmdlet de proxy ignora esse parâmetro, pois não tem suporte do CommandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

O cmdlet de proxy ignora esse parâmetro, pois não tem suporte do CommandNameParameterSet de Find-PSResource.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

PSGetCommandInfo

Find-Command gera um objeto PSGetCommandInfo .

Observações

O Galeria do PowerShell não dá mais suporte às versões 1.0 e 1.1 do protocolo TLS. Você deve usar o TLS 1.2 ou superior. Use o seguinte comando para garantir que esteja usando o TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12