Partilhar via

Get-Package

  • Referência
Módulo:
PackageManagement

Devolve 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 devolve uma lista de todos os pacotes de software no computador local que foram instalados com PackageManagement. Pode executar Get-Package em computadores remotos ao executá-lo como parte de um Invoke-Command comando ou Enter-PSSession script.

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: 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 num computador remoto

Este comando obtém uma lista de pacotes que foram instalados pelo PackageManagement num computador remoto. Este comando pede-lhe para fornecer a palavra-passe do utilizador especificado.

PS> Invoke-Command -ComputerName Server01 -Credential CONTOSO\TestUser -ScriptBlock {Get-Package}

Invoke-Command utiliza o parâmetro ComputerName para especificar um computador remoto, Server01. O parâmetro Credencial especifica um domínio e um nome de utilizador 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 fornecedor especificado

Este comando obtém pacotes de software instalados no computador local a partir de um fornecedor 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 utiliza o parâmetro ProviderName para especificar um fornecedor específico, o PowerShellGet. O parâmetro AllVersions apresenta cada versão instalada.

Exemplo 4: Obter uma versão exata de um pacote específico

Este comando obtém uma versão específica de um pacote instalado. Pode instalar mais do que uma versão de um pacote.

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 utiliza o parâmetro Nome para especificar o nome do pacote PackageManagement. O parâmetro ProviderName especifica o fornecedor PowerShellGet. O parâmetro RequiredVersion especifica uma versão instalada.

Exemplo 5: Desinstalar um pacote

Este exemplo obtém as informações do pacote e, em seguida, desinstala o pacote.

Get-Package -Name posh-git -RequiredVersion 0.7.3 | Uninstall-Package

Get-Package utiliza o parâmetro Nome 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 comandos existentes que têm o mesmo nome que os comandos que estão a ser 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 devolve todas as versões disponíveis do pacote. Por predefinição, Get-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

-Destination

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

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

-ExcludeVersion

Mude para excluir o número da 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 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 Get-Package força a 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

-InstallUpdate

Indica que este 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 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 será 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

-NoPathUpdate

NoPathUpdate aplica-se apenas ao Install-Script cmdlet. NoPathUpdate é um parâmetro dinâmico adicionado pelo fornecedor e não é suportado 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 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

-RequiredVersion

Especifica a versão exata do pacote a localizar.

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

-Scope

Especifica o âmbito 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

Altere o que especifica para ignorar a localização de quaisquer dependências do pacote.

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

-SkipPublisherCheck

Permite-lhe obter uma versão de pacote mais recente do que a versão instalada. Por exemplo, um pacote instalado assinado digitalmente por um fabricante fidedigno, mas que não tem uma nova versão assinada digitalmente.

Type:SwitchParameter
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

Saídas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Este cmdlet devolve um objeto SoftwareIdentity para cada pacote instalado que corresponda aos parâmetros. Por predefinição, devolve todos os pacotes instalados.

Notas

Incluir um fornecedor de pacotes num comando pode disponibilizar parâmetros dinâmicos a um cmdlet. Os parâmetros dinâmicos são específicos de um fornecedor de pacotes. O Get-Help cmdlet lista os conjuntos de parâmetros de um cmdlet e inclui o conjunto de parâmetros do fornecedor. Por exemplo, Get-Package tem o conjunto de parâmetros PowerShellGet que inclui -NoPathUpdate, AllowClobbere SkipPublisherCheck.

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.