Compartilhar via


Get-Package

Retorna uma lista de todos os pacotes de software que foram instalados com PackageManagement.

Syntax

Get-Package
   [[-Name] <String[]>]
   [-RequiredVersion <String>]
   [-MinimumVersion <String>]
   [-MaximumVersion <String>]
   [-AllVersions]
   [-Force]
   [-ForceBootstrap]
   [-ProviderName <String[]>]
   [-Destination <String>]
   [-ExcludeVersion]
   [-Scope <String>]
   [-SkipDependencies]
   [<CommonParameters>]
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 Get-Package cmdlet 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 comando ou script ou .Enter-PSSession

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 Get-Package cmdlet 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 Credential especifica um domínio e um nome de usuário com permissões para executar comandos no computador. O parâmetro ScriptBlock executa o Get-Package cmdlet 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, o 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, 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 Uninstall-Package cmdlet . 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.

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 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Especifica o caminho para um diretório que contém arquivos de pacote extraídos.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeVersion

Alterne para excluir o número de versão no caminho da pasta.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceBootstrap

Indica que Get-Package força o PackageManagement a instalar automaticamente o provedor de pacotes.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstallUpdate

Indica que esse cmdlet instala atualizações.

Type:SwitchParameter
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 você deseja encontrar.

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 você deseja encontrar. Se uma versão superior estiver disponível, essa versão será retornada.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-NoPathUpdate

NoPathUpdate só se aplica ao Install-Script cmdlet . NoPathUpdate é um parâmetro dinâmico adicionado pelo provedor e não tem suporte pelo Get-Package.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProvider

Especifica o nome de um provedor de gerenciamento 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 provedor de pacotes. Separe vários nomes de provedor de pacotes com vírgulas. Use Get-PackageProvider para obter uma lista de provedores 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

-RequiredVersion

Especifica a versão exata do pacote a ser encontrada.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Especifica o escopo de pesquisa do pacote.

Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencies

Opção que especifica ignorar a localização de dependências de pacote.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipPublisherCheck

Permite que você obtenha uma versão do pacote mais recente do 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Especifica se os pacotes devem ser pesquisados com um módulo, um script ou qualquer um.

Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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. Os parâmetros dinâmicos são específicos para um provedor de pacotes. O Get-Help cmdlet 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 dará mais suporte às versões 1.0 e 1.1 do protocolo TLS. Se você não estiver usando o TLS 1.2 ou posterior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que esteja usando o TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Para obter mais informações, confira o comunicado no blog do PowerShell.