Find-Command
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 PSGalleryFind-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
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de