Find-Command
Localiza comandos do PowerShell em módulos.
Sintaxe
All
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 cmdlet Find-Command localiza comandos do PowerShell, como cmdlets, aliases, funções e fluxos de trabalho.
Find-Command módulos de pesquisa em repositórios registados.
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 Find-Command parâmetro cmdlets ModuleName .
Caso contrário, poderão ser instalados módulos que você não deseja 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 procurar 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 a saída de status 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.
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
O cmdlet proxy ignora esse parâmetro, pois não é suportado pelo CommandNameParameterSet do Find-PSResource.
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 |
-Filter
O cmdlet proxy ignora esse parâmetro, pois não é suportado pelo CommandNameParameterSet do Find-PSResource.
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 |
-MaximumVersion
O cmdlet proxy ignora esse parâmetro, pois não é suportado pelo CommandNameParameterSet do Find-PSResource.
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 |
-MinimumVersion
O cmdlet proxy ignora esse parâmetro, pois não é suportado pelo CommandNameParameterSet do Find-PSResource.
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 |
-ModuleName
O cmdlet proxy ignora esse parâmetro, pois não é suportado pelo CommandNameParameterSet do Find-PSResource.
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 |
-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.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Proxy
O cmdlet proxy ignora esse parâmetro, pois não é suportado pelo CommandNameParameterSet do Find-PSResource.
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
O cmdlet proxy ignora esse parâmetro, pois não é suportado pelo CommandNameParameterSet do Find-PSResource.
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
Especifica o repositório para procurar comandos. Use vírgulas para separar uma matriz de nomes de repositório. O padrão é todos os repositórios.
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
O cmdlet proxy ignora esse parâmetro, pois não é suportado pelo CommandNameParameterSet do Find-PSResource.
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
O cmdlet proxy ignora esse parâmetro, pois não é suportado pelo CommandNameParameterSet do Find-PSResource.
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.
Saídas
PSGetCommandInfo
Find-Command gera uma objeto de PSGetCommandInfo.
Notas
A Galeria do PowerShell não suporta mais as versões 1.0 e 1.1 do Transport Layer Security (TLS). Você deve usar TLS 1.2 ou superior. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
