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 o PackageManagement. Você pode executar Get-Package em computadores remotos executando-os como parte de um comando ou script Invoke-Command 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. 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
Este comando obtém uma lista de pacotes que foram instalados pelo PackageManagement em um computador remoto. Este 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 cmdlet Get-Package no computador remoto.
Exemplo 3: Obter pacotes para um provedor especificado
Este 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, PowerShellGet.
O parâmetro AllVersions exibe 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. 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 Name parâmetro 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, em seguida, 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 comandos existentes que têm o mesmo nome que os comandos que estão sendo instalados por um módulo.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PowerShellGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-AllowPrereleaseVersions
Inclui pacotes marcados como pré-lançamento nos resultados.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PowerShellGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Destination
Especifica o caminho para um diretório que contém arquivos de pacote extraídos.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NuGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ExcludeVersion
Alterne para excluir o número da versão no caminho da pasta.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NuGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ForceBootstrap
Indica que Get-Package força PackageManagement a instalar automaticamente o provedor de pacotes.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InstallUpdate
Indica que esse cmdlet instala atualizações.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PowerShellGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-MaximumVersion
Especifica a versão máxima do pacote que você deseja localizar.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica um ou mais nomes de pacotes ou nomes de pacotes com caracteres curinga. Separe vários nomes de pacotes com vírgulas.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-NoPathUpdate
NoPathUpdate só se aplica ao Install-Script cmdlet.
NoPathUpdate é um parâmetro dinâmico adicionado pelo provedor e não é suportado pelo Get-Package.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PowerShellGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PackageManagementProvider
Especifica o nome de um provedor de gerenciamento de pacotes.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PowerShellGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ProviderName
Especifica um ou mais nomes de provedores 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 dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Valores aceites: | Bootstrap, NuGet, PowerShellGet |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Fornecedor |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-RequiredVersion
Especifica a versão exata do pacote a ser localizada.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Scope
Especifica o escopo de pesquisa para o pacote.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Valores aceites: | CurrentUser, AllUsers |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SkipDependencies
Opção que especifica para ignorar a localização de quaisquer dependências de pacote.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NuGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SkipPublisherCheck
Permite que você obtenha uma versão do pacote que é 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PowerShellGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Type
Especifica se os pacotes devem ser pesquisados com um módulo, um script ou ambos.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Valores aceites: | Module, Script, All |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PowerShellGet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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
Este cmdlet retorna um objeto SoftwareIdentity para cada pacote instalado que corresponde aos parâmetros. Por padrão, ele retorna todos os pacotes instalados.
Notas
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 de 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 PowerShellGet que inclui -NoPathUpdate, AllowClobbere SkipPublisherCheck.
Importante
A partir de abril de 2020, a Galeria do PowerShell não suporta mais as versões 1.0 e 1.1 do Transport Layer Security (TLS). 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 de anúncio de
