Find-Package
Localiza pacotes de software em origens de pacotes disponíveis.
Syntax
Find-Package
[-IncludeDependencies]
[-AllVersions]
[-Source <String[]>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Force]
[-ForceBootstrap]
[-ProviderName <String[]>]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[<CommonParameters>]Find-Package
[-IncludeDependencies]
[-AllVersions]
[-Source <String[]>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Force]
[-ForceBootstrap]
[-ProviderName <String[]>]
[-AllowPrereleaseVersions]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[<CommonParameters>]Description
Find-Package localiza pacotes de software que estão disponíveis em origens de pacotes. Get-PackageProvider e Get-PackageSource apresente detalhes sobre os seus fornecedores.
Importante
Os comandos contidos no módulo PackageManagement são diferentes dos comandos fornecidos pelo módulo NuGet na Consola do Gestor de Pacotes do Visual Studio. Cada módulo tem comandos que não estão disponíveis no outro. Os comandos com o mesmo nome diferem nos respetivos argumentos específicos. Para obter mais informações, veja a documentação de referência do PowerShell para a Consola do Gestor de Pacotes do Visual Studio.
Exemplos
Exemplo 1: localizar todos os pacotes disponíveis a partir de um fornecedor de pacotes
Este comando localiza todos os pacotes de módulos do PowerShell disponíveis numa galeria registada. Utilize Get-PackageProvider para obter o nome do fornecedor.
Find-Package -ProviderName NuGet
Name Version Source Summary
---- ------- ------ -------
NUnit 3.11.0 MyNuGet NUnit is a unit-testing framework for all .NET langua...
Newtonsoft.Json 12.0.1 MyNuGet Json.NET is a popular high-performance JSON framework...
EntityFramework 6.2.0 MyNuGet Entity Framework is Microsoft's recommended data acce...
MySql.Data 8.0.15 MyNuGet MySql.Data.MySqlClient .Net Core Class Library
bootstrap 4.3.1 MyNuGet Bootstrap framework in CSS. Includes fonts and JavaSc...
NuGet.Core 2.14.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utiliza o parâmetro Fornecedor para especificar o NuGet do fornecedor.
Exemplo 2: localizar um pacote a partir de uma origem de pacote
Este comando localiza a versão mais recente de um pacote a partir de uma origem de pacote especificada. Se não for fornecida uma origem de pacote, Find-Package procura cada fornecedor de pacotes instalado e as respetivas origens de pacotes. Utilize Get-PackageSource para obter o nome de origem.
Find-Package -Name NuGet.Core -Source MyNuGet
Name Version Source Summary
---- ------- ------ -------
NuGet.Core 2.14.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utiliza o parâmetro Nome para especificar o nome do pacote NuGet.Core. O parâmetro Origem especifica para procurar o pacote em MyNuGet.
Exemplo 3: localizar todas as versões de um pacote
Este comando localiza todas as versões de pacote disponíveis de um fornecedor especificado.
Find-Package -Name NuGet.Core -Source MyNuGet -AllVersions
Name Version Source Summary
---- ------- ------ -------
NuGet.Core 2.14.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.14.0-rtm-832 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.13.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...
...
NuGet.Core 1.1.229.159 MyNuGet NuGet.Core is the core framework assembly for NuGet...
Nuget.Core 1.0.1120.104 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utiliza o parâmetro Name para especificar o pacote NuGet.Core. O parâmetro ProviderName especifica para procurar o pacote em MyNuGet. AllVersions especifica que todas as versões disponíveis são devolvidas.
Exemplo 4: localizar um pacote com um nome e versão específicos
Este comando localiza uma versão de pacote específica de um fornecedor especificado.
Find-Package -Name NuGet.Core -ProviderName NuGet -RequiredVersion 2.9.0
Name Version Source Summary
---- ------- ------ -------
NuGet.Core 2.9.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utiliza o parâmetro Nome para especificar o nome do pacote NuGet.Core. O parâmetro ProviderName especifica para procurar o pacote no NuGet. RequiredVersion especifica que apenas é devolvida a versão 2.9.0 .
Exemplo 5: localizar pacotes num intervalo de versões
Este comando localiza um intervalo de versões para um pacote especificado.
Find-Package -Name NuGet.Core -ProviderName NuGet -MinimumVersion 2.7.0 -MaximumVersion 2.9.0 -AllVersions
Name Version Source Summary
---- ------- ------ -------
NuGet.Core 2.9.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.8.6 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.8.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...
NuGet.Core 2.7.0 MyNuGet NuGet.Core is the core framework assembly for NuGet...Find-Package utiliza o parâmetro Nome para especificar o nome do pacote NuGet.Core. O parâmetro ProviderName especifica para procurar o pacote no NuGet. MinimumVersion especifica a versão mais baixa 2.7.0. MaximumVersion especifica a versão mais alta 2.9.0.
AllVersions determina que o intervalo é devolvido conforme especificado pelo mínimo e máximo.
Exemplo 6: localizar um pacote a partir de um sistema de ficheiros
Este comando localiza pacotes com a extensão .nupkg de ficheiro que estão armazenados no computador local.
Os ficheiros são pacotes transferidos de uma galeria, como o NuGet.
PS> Find-Package -Source C:\LocalPkg
Name Version Source Summary
---- ------- ------ -------
Microsoft.Web.Xdt 3.0.0 C:\LocalPkg\ Microsoft Xml Document Transformation (XDT)...
NuGet.Core 2.14.0 C:\LocalPkg\ NuGet.Core is the core framework assembly...Parâmetros
-AcceptLicense
Aceita automaticamente um contrato de licença se o pacote o exigir.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowPrereleaseVersions
Inclui pacotes marcados como pré-lançamento nos resultados.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
Indica que Find-Package devolve todas as versões disponíveis do pacote. Por predefinição, Find-Package só devolve a versão mais recente disponível.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Command
Especifica uma matriz de comandos pesquisados por Find-Package.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConfigFile
Especifica um ficheiro de configuração.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Contains
Find-Package obtém objetos se qualquer item nos valores de propriedade do objeto for uma correspondência exata para o valor especificado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Especifica uma conta de utilizador que tem permissão para procurar pacotes.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DscResource
Especifica uma matriz de recursos Desired State Configuration (DSC) que este cmdlet procura.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
Especifica os termos a procurar nas propriedades Nome e Descrição .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilterOnTag
Especifica a etiqueta que filtra os resultados. Os resultados que não contêm a etiqueta especificada são excluídos.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do utilizador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceBootstrap
Indica que Find-Package força o PackageManagement a instalar automaticamente o fornecedor de pacotes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Headers
Especifica os cabeçalhos do pacote.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeDependencies
Indica que este cmdlet inclui dependências de pacotes nos resultados.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Includes
Especifica se Find-Package deve encontrar todos os pacotes numa categoria.
Os valores aceites são os seguintes:
- Cmdlet
- DscResource
- Função
- RoleCapability
- Fluxo de trabalho
| Type: | String[] |
| Accepted values: | Cmdlet, DscResource, Function, RoleCapability, Workflow |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
Especifica a versão máxima do pacote que pretende localizar.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
Especifica a versão mínima do pacote que pretende localizar. Se estiver disponível uma versão superior, essa versão é devolvida.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica um ou mais nomes de pacotes ou nomes de pacotes com carateres universais. Separe vários nomes de pacotes com vírgulas.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-PackageManagementProvider
Especifica o nome de um fornecedor de gestão de pacotes.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProviderName
Especifica um ou mais nomes de fornecedores de pacotes. Separe vários nomes de fornecedores de pacotes com vírgulas.
Utilize Get-PackageProvider para obter uma lista de fornecedores de pacotes disponíveis.
| Type: | String[] |
| Aliases: | Provider |
| Accepted values: | Bootstrap, NuGet, PowerShellGet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Proxy
Especifica um servidor proxy para o pedido, em vez de uma ligação direta ao recurso da Internet.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProxyCredential
Especifica uma conta de utilizador que tem permissão para utilizar o servidor proxy especificado pelo parâmetro Proxy .
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublishLocation
Especifica uma localização para publicar o pacote.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
Especifica uma versão exata do pacote que pretende localizar.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RoleCapability
Especifica uma matriz de capacidades de função.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptPublishLocation
Especifica uma localização de publicação de scripts para o pacote.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptSourceLocation
Especifica uma localização de origem do script.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipValidate
Comutador que ignora a validação de credenciais do pacote.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Source
Especifica uma ou mais origens de pacotes. Utilize Get-PackageSource para obter uma lista de origens de pacotes disponíveis. Um diretório de sistema de ficheiros pode ser utilizado como origem para pacotes de transferência.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
Especifica uma ou mais cadeias de carateres a procurar nos metadados do pacote.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Type
Especifica se pretende procurar pacotes com um módulo, um script ou qualquer um deles.
| Type: | String |
| Accepted values: | Module, Script, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
None
Não pode encaminhar objetos para este cmdlet.
Saídas
SoftwareIdentify[]
Este cmdlet devolve um objeto SoftwareIdentity .
Notas
Importante
A partir de abril de 2020, o Galeria do PowerShell já não suporta as versões 1.0 e 1.1 do Transport Layer Security (TLS). Se não estiver a utilizar o TLS 1.2 ou superior, receberá um erro ao tentar aceder ao Galeria do PowerShell. Utilize o seguinte comando para garantir que está a utilizar o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Para obter mais informações, veja o anúncio no blogue do PowerShell.
