Get-Package
Retorna uma lista de todos os pacotes de software que foram instalados com PackageManagement.
Sintaxe
NuGet
Get-Package
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-ProviderName <String[]>]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]
PowerShellGet
Get-Package
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-ProviderName <String[]>]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-Type <String>]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[-AllowPrereleaseVersions]
[<CommonParameters>]
Description
O cmdlet Get-Package retorna uma lista de todos os pacotes de software no computador local que foram instalados com PackageManagement. Você pode executar Get-Package em computadores remotos executando-o como parte de um Invoke-Command ou Enter-PSSession comando ou script.
Importante
Os comandos contidos no módulo PackageManagement são diferentes dos comandos fornecidos pelo módulo NuGet no Console do Gerenciador 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 em seus argumentos específicos. Para obter mais informações, consulte a documentação de referência do PowerShell para o Console do Gerenciador de Pacotes do Visual Studio.
Exemplos
Exemplo 1: Obter todos os pacotes instalados
O cmdlet Get-Package obtém todos os pacotes instalados no computador local.
Get-Package
Name Version Source ProviderName
---- ------- ------ ------------
posh-git 0.7.3 https://www.powershellgallery.com/api/v2 PowerShellGet
Exemplo 2: Obter pacotes instalados em um computador remoto
Esse comando obtém uma lista de pacotes que foram instalados pelo PackageManagement em um computador remoto. Esse comando solicita que você forneça a senha do usuário especificado.
PS> Invoke-Command -ComputerName Server01 -Credential CONTOSO\TestUser -ScriptBlock {Get-Package}
Invoke-Command usa o parâmetro ComputerName para especificar um computador remoto, Server01. O parâmetro de Credenciais especifica um domínio e um nome de usuário com permissões para executar comandos no computador. O parâmetro ScriptBlock executa o cmdlet Get-Package no computador remoto.
Exemplo 3: Obter pacotes para um provedor especificado
Esse comando obtém pacotes de software instalados no computador local de um provedor específico.
Get-Package -ProviderName PowerShellGet -AllVersions
Name Version Source ProviderName
---- ------- ------ ------------
PackageManagement 1.2.2 https://www.powershellgallery.com/api/v2 PowerShellGet
PackageManagement 1.3.1 https://www.powershellgallery.com/api/v2 PowerShellGet
posh-git 0.7.3 https://www.powershellgallery.com/api/v2 PowerShellGet
PowerShellGet 2.0.1 https://www.powershellgallery.com/api/v2 PowerShellGet
Get-Package usa o parâmetro ProviderName para especificar um provedor específico, do PowerShellGet.
O parâmetro AllVersions exibe cada versão instalada.
Exemplo 4: Obter uma versão exata de um pacote específico
Esse comando obtém uma versão específica de um pacote instalado. Mais de uma versão de um pacote pode ser instalada.
Get-Package -Name PackageManagement -ProviderName PowerShellGet -RequiredVersion 1.3.1
Name Version Source ProviderName
---- ------- ------ ------------
PackageManagement 1.3.1 https://www.powershellgallery.com/api/v2 PowerShellGet
Get-Package usa o parâmetro Name para especificar o nome do pacote, PackageManagement. O parâmetro ProviderName especifica o provedor, do PowerShellGet. O parâmetro RequiredVersion especifica uma versão instalada.
Exemplo 5: Desinstalar um pacote
Este exemplo obtém informações do pacote e desinstala o pacote.
Get-Package -Name posh-git -RequiredVersion 0.7.3 | Uninstall-Package
Get-Package usa o parâmetro Name para especificar o nome do pacote, posh-git. O parâmetro RequiredVersion é uma versão específica do pacote. O objeto é enviado pelo pipeline para o cmdlet Uninstall-Package.
Uninstall-Package remove o pacote.
Parâmetros
-AllowClobber
Substitui mensagens de aviso sobre conflitos com comandos existentes. Substitui os comandos existentes que têm o mesmo nome que os comandos que estão sendo instalados por um módulo.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
PowerShellGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AllowPrereleaseVersions
Inclui pacotes marcados como pré-lançamento nos resultados.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
PowerShellGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AllVersions
Indica que Get-Package retorna todas as versões disponíveis do pacote. Por padrão, Get-Package retorna apenas a versão mais recente disponível.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Destination
Especifica o caminho para um diretório que contém arquivos de pacote extraídos.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NuGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExcludeVersion
Alterne para excluir o número de versão no caminho da pasta.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NuGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ForceBootstrap
Indica que Get-Package força PackageManagement a instalar automaticamente o provedor de pacotes.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InstallUpdate
Indica que esse cmdlet instala atualizações.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
PowerShellGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MaximumVersion
Especifica a versão máxima do pacote que você deseja localizar.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MinimumVersion
Especifica a versão mínima do pacote que você deseja localizar. Se uma versão superior estiver disponível, essa versão será retornada.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Especifica um ou mais nomes de pacote ou nomes de pacote com caracteres curinga. Separe vários nomes de pacote com vírgulas.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-NoPathUpdate
NoPathUpdate só se aplica ao Install-Script cmdlet.
NoPathUpdate é um parâmetro dinâmico adicionado pelo provedor e não tem suporte.Get-Package
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
PowerShellGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PackageManagementProvider
Especifica o nome de um provedor de gerenciamento de pacotes.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
PowerShellGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ProviderName
Especifica um ou mais nomes de provedor de pacotes. Separe vários nomes de provedores de pacotes com vírgulas.
Use Get-PackageProvider para obter uma lista de provedores de pacotes disponíveis.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Valores aceitos: | Bootstrap, NuGet, PowerShellGet |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Fornecedor |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-RequiredVersion
Especifica a versão exata do pacote a ser localizado.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Scope
Especifica o escopo de pesquisa do pacote.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Valores aceitos: | CurrentUser, AllUsers |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SkipDependencies
Alternar que especifica ignorar a localização de quaisquer dependências de pacote.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NuGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SkipPublisherCheck
Permite que você obtenha uma versão do pacote mais recente que a versão instalada. Por exemplo, um pacote instalado que é assinado digitalmente por um editor confiável, mas uma nova versão não é assinada digitalmente.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
PowerShellGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Type
Especifica se os pacotes devem ser pesquisados com um módulo, um script ou qualquer um.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Valores aceitos: | Module, Script, All |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
PowerShellGet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Esse cmdlet retorna um objeto SoftwareIdentity para cada pacote instalado que corresponde aos parâmetros. Por padrão, ele retorna todos os pacotes instalados.
Observações
Incluir um provedor de pacotes em um comando pode disponibilizar parâmetros dinâmicos para um cmdlet. Parâmetros dinâmicos são específicos para um provedor de pacotes. O cmdlet Get-Help lista os conjuntos de parâmetros de um cmdlet e inclui o conjunto de parâmetros do provedor. Por exemplo, Get-Package tem o conjunto de parâmetros do PowerShellGet que inclui -NoPathUpdate, AllowClobbere SkipPublisherCheck.
Importante
A partir de abril de 2020, a Galeria do PowerShell não dá mais suporte ao TLS (Transport Layer Security) versões 1.0 e 1.1. Se você não estiver usando o TLS 1.2 ou superior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Para obter mais informações, consulte o comunicado no blog do PowerShell.