Install-Package
Instala um ou mais pacotes de software.
Sintaxe
Install-Package
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Source <String[]>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ProviderName <String[]>]
[<CommonParameters>]Install-Package
[-InputObject] <SoftwareIdentity[]>
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-AllowPrereleaseVersions]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[<CommonParameters>]Install-Package
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-AllowPrereleaseVersions]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[<CommonParameters>]Description
O Install-Package cmdlet instala um ou mais pacotes de software no computador local. Se você tiver várias fontes de software, use Get-PackageProvider e Get-PackageSource exiba detalhes sobre seus provedores.
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: instalar um pacote pelo nome do pacote
O Install-Package cmdlet instala um pacote de software e suas dependências.
PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser
Install-Package usa parâmetros para especificar o nome e a origem dos pacotes. O parâmetro Credential usa uma conta de usuário de domínio com permissões para instalar pacotes. O comando solicita a senha da conta de usuário.
Exemplo 2: usar Find-Package para instalar um pacote
Neste exemplo, o objeto retornado pelo Find-Package é enviado pelo pipeline e instalado por Install-Package.
PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package
Find-Package usa os parâmetros Nome e Origem para localizar um pacote. O objeto é enviado pelo pipeline e Install-Package instala o pacote no computador local.
Exemplo 3: instalar pacotes especificando um intervalo de versões
Install-Package usa os parâmetros MinimumVersion e MaximumVersion para especificar um intervalo de versões de software.
PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0
Install-Package usa os parâmetros Nome e Origem para localizar um pacote. Os parâmetros MinimumVersion e MaximumVersion especificam um intervalo de versões de software. A versão mais alta do intervalo é instalada.
Parâmetros
-AcceptLicense
O AcceptLicense aceita automaticamente o contrato de licença durante a instalação.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-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.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AllowPrereleaseVersions
Permite a instalação de pacotes marcados como pré-lançamento.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AllVersions
Install-Package instala todas as versões disponíveis do pacote. Por padrão, somente a versão mais recente está instalada.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Command
Especifica um ou mais comandos que Install-Package pesquisam.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ConfigFile
Especifica um caminho que contém um arquivo de configuração.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Contains
Install-Package obtém objetos se o parâmetro Contains especifica um valor que corresponde a qualquer um dos valores de propriedade do objeto.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Credential
Especifica uma conta de usuário que tem permissão para acessar o computador e executar comandos. Digite um nome de usuário, como User01, Domain01\User01 ou insira um objeto PSCredential , gerado pelo Get-Credential cmdlet. Se você digitar um nome de usuário, será solicitado que você solicite uma senha.
Quando o parâmetro Credential não é especificado, Install-Package usa o usuário atual.
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Destination
Especifica um caminho para um objeto de entrada.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DscResource
Especifica um ou mais recursos de DSC (Configuração de Estado Desejado) que são pesquisados por Install-Package. Use o Find-DscResource cmdlet para localizar recursos de DSC.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ExcludeVersion
Alterne para excluir o número de versão no caminho da pasta.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Filter
Especifica os termos a serem pesquisados nas propriedades Nome e Descrição .
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-FilterOnTag
Especifica uma marca que filtra os resultados e exclui resultados que não contêm a marca especificada.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário. Substitui restrições que impedem Install-Package o sucesso, com exceção da segurança.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceBootstrap
Força o PackageManagement a instalar automaticamente o provedor de pacotes para o pacote especificado.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Headers
Especifica os cabeçalhos do pacote.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Includes
Especifica se Install-Package todos os tipos de pacote devem ser encontrados. Os valores aceitáveis para esse parâmetro são os seguintes:
- Cmdlet
- DscResource
- Função
- RoleCapability
- Fluxo de Trabalho
| Tipo: | String[] |
| Valores aceitos: | Cmdlet, DscResource, Function, RoleCapability, Workflow |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InputObject
Aceita entrada de pipeline. Especifica um pacote usando o tipo SoftwareIdentity do pacote.
Find-Package gera um objeto SoftwareIdentity .
| Tipo: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-InstallUpdate
Indica que Install-Package instala atualizações.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MaximumVersion
Especifica a versão máxima do pacote permitida que você deseja instalar. Se você não especificar esse parâmetro, Install-Package instalará a versão mais recente do pacote.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MinimumVersion
Especifica a versão mínima do pacote permitida que você deseja instalar. Se você não adicionar esse parâmetro, Install-Package instalará a versão mais recente do pacote que satisfaça qualquer versão especificada pelo parâmetro MaximumVersion .
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifica um ou mais nomes de pacote. Vários nomes de pacote devem ser separados por vírgulas.
| Tipo: | String[] |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NoPathUpdate
NoPathUpdate só se aplica ao Install-Script cmdlet.
NoPathUpdate é um parâmetro dinâmico adicionado pelo provedor e não tem suporte.Install-Package
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PackageManagementProvider
Especifica o nome do provedor PackageManagement .
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ProviderName
Especifica um ou mais nomes de provedor de pacotes para os quais definir o escopo da pesquisa de pacotes. Você pode obter nomes de provedor de pacotes executando o Get-PackageProvider cmdlet.
| Tipo: | String[] |
| Aliases: | Provider |
| Valores aceitos: | Bootstrap, NuGet, PowerShellGet |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Proxy
Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente a um recurso da Internet.
| Tipo: | Uri |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ProxyCredential
Especifica uma conta de usuário que tem permissão para usar o servidor proxy especificado pelo parâmetro proxy.
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PublishLocation
Especifica o caminho para o local publicado de um pacote.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RequiredVersion
Especifica a versão exata permitida do pacote que você deseja instalar. Se você não adicionar esse parâmetro, Install-Package instalará a versão mais recente do pacote que satisfaça qualquer versão especificada pelo parâmetro MaximumVersion .
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RoleCapability
Especifica uma matriz de recursos de função.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Scope
Especifica o escopo para o qual instalar o pacote. Os valores aceitáveis para esse parâmetro são os seguintes:
- UsuárioAtual
- AllUsers
| Tipo: | String |
| Valores aceitos: | CurrentUser, AllUsers |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ScriptPublishLocation
Especifica o caminho para o local publicado de um script.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ScriptSourceLocation
Especifica o local de origem do script.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkipDependencies
Ignora a instalação de dependências de software.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkipValidate
Alterne que ignora a validação das credenciais de um pacote.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Source
Especifica uma ou mais fontes de pacote. Vários nomes de origem do pacote devem ser separados por vírgulas.
Você pode obter nomes de origem do pacote executando o Get-PackageSource cmdlet.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Tag
Especifica uma ou mais cadeias de caracteres a serem pesquisadas nos metadados do pacote.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Type
Especifica se os pacotes devem ser pesquisados com um módulo, um script ou ambos. Os valores aceitáveis para esse parâmetro são os seguintes:
- Módulo
- Script
- Todos
| Tipo: | String |
| Valores aceitos: | Module, Script, All |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se Install-Package o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Você pode canalizar um objeto SoftwareIdentity para este cmdlet.
Saídas
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Esse cmdlet retorna um objeto SoftwareIdentity para cada pacote que ele instala.
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 Get-Help cmdlet lista os conjuntos de parâmetros de um cmdlet e inclui o conjunto de parâmetros do provedor. Por exemplo, Install-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.
