Compartilhar via


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.