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 procura módulos em repositórios registados.
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 comando por nome
Find-Command pode utilizar o nome de um comando para localizar o módulo num 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 utiliza o parâmetro Repository para procurar no 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, utilize o parâmetro ModuleName dos Find-Command cmdlets.
Caso contrário, poderão ser instalados módulos que 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 utiliza o parâmetro Nome para especificar o comando Get-TargetResource. O parâmetro Repository procura na PSGallery. O parâmetro ModuleName especifica o módulo que pretende instalar, SystemLocaleDsc. O objeto é enviado pelo pipeline para Install-Module e o módulo é instalado. Após a conclusão da instalação, pode utilizar Get-InstalledModule para apresentar os resultados.
Exemplo 3: localizar um comando e guardar o 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 utiliza os parâmetros Nome e Repositório para procurar o comando Invoke-ScriptAnalyzer no repositório PSGallery . O objeto é enviado pelo pipeline para Save-Module. O parâmetro Path determina a localização para guardar o módulo. Verboso é um parâmetro opcional, mas apresenta a saída do estado na consola do PowerShell. A saída verbosa é benéfica para a resolução de problemas.
Parâmetros
-AllowPrerelease
Inclui módulos marcados como pré-lançamento nos resultados.
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
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo CommandNameParameterSet de Find-PSResource.
| Type: | SwitchParameter |
| 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 CommandNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo CommandNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo CommandNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo 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 procurar num repositório. Utilize vírgulas para separar uma matriz de nomes de comandos.
O cmdlet proxy mapeia este 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 proxy ignora este parâmetro, uma vez que não é suportado pelo CommandNameParameterSet 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 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 procurar comandos. Utilize vírgulas para separar uma matriz de nomes de repositório. A predefiniçã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 proxy ignora este parâmetro, uma vez que não é suportado pelo CommandNameParameterSet de Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo 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 produz um objeto PSGetCommandInfo .
Notas
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
Ligações Relacionadas
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários