Install-Package

Módulo:

PackageManagement

Instala um ou mais pacotes de software.

Syntax

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 tiver várias origens de software, utilize Get-PackageProvider e Get-PackageSource para apresentar detalhes sobre os seus fornecedores.

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: Instalar um pacote por nome de pacote

O Install-Package cmdlet instala um pacote de software e as respetivas dependências.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Install-Package utiliza parâmetros para especificar os pacotes Nome e Origem. O parâmetro Credential utiliza uma conta de utilizador de domínio com permissões para instalar pacotes. O comando pede-lhe a palavra-passe da conta de utilizador.

Exemplo 2: Utilizar Find-Package para instalar um pacote

Neste exemplo, o objeto devolvido por Find-Package é enviado pelo pipeline e instalado pelo Install-Package.

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-Package utiliza 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 ao especificar um intervalo de versões

Install-Package utiliza os parâmetros MinimumVersion e MaximumVersion para especificar uma gama de versões de software.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

Install-Package utiliza os parâmetros Nome e Origem para localizar um pacote. Os parâmetros MinimumVersion e MaximumVersion especificam uma gama de versões de software. A versão mais alta do intervalo está instalada.

Parâmetros

-AcceptLicense

AcceptLicense aceita automaticamente o contrato de licença durante a instalação.

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

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

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

-AllowPrereleaseVersions

Permite a instalação de pacotes marcados como pré-lançamento.

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

-AllVersions

Install-Package instala todas as versões disponíveis do pacote. Por predefinição, só está instalada a versão mais recente.

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

-Command

Especifica um ou mais comandos que Install-Package pesquisam.

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

-ConfigFile

Especifica um caminho que contém um ficheiro de configuração.

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-Contains

Install-Package obtém objetos se o parâmetro Contém especificar um valor que corresponda a qualquer um dos valores de propriedade do objeto.

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

-Credential

Especifica uma conta de utilizador que tem permissão para aceder ao computador e executar comandos. Escreva um nome de utilizador, como User01, Domain01\User01 ou introduza um objeto PSCredential , gerado pelo Get-Credential cmdlet . Se escrever um nome de utilizador, ser-lhe-á pedida uma palavra-passe.

Quando o parâmetro Credential não é especificado, Install-Package utiliza o utilizador atual.

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

-Destination

Especifica um caminho para um objeto de entrada.

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

-DscResource

Especifica um ou mais recursos de Desired State Configuration (DSC) que são pesquisados por Install-Package. Utilize o Find-DscResource cmdlet para localizar recursos do DSC.

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

-Filter

Especifica os termos a procurar nas propriedades Nome e Descrição .

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

-FilterOnTag

Especifica uma etiqueta que filtra os resultados e exclui os resultados que não contêm a etiqueta especificada.

Type:	String[]
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. Substitui as restrições que impedem Install-Package o sucesso, com exceção da segurança.

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

-ForceBootstrap

Força o PackageManagement a instalar automaticamente o fornecedor de pacotes para o pacote especificado.

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

-Headers

Especifica os cabeçalhos do pacote.

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

-Includes

Especifica se Install-Package deve encontrar todos os tipos de pacote. Os valores aceitáveis para este parâmetro são os seguintes:

• Cmdlet
• DscResource
• Função
• RoleCapability
• Fluxo de trabalho

Type:	String[]
Accepted values:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Aceita a entrada do pipeline. Especifica um pacote com o tipo SoftwareIdentity do pacote. Find-Package produz um objeto SoftwareIdentity .

Type:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallUpdate

Indica que Install-Package 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 permitida do pacote que pretende instalar. Se não especificar este parâmetro, Install-Package o instala a versão mais recente do pacote.

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

-MinimumVersion

Especifica a versão mínima permitida do pacote que pretende instalar. Se não adicionar este parâmetro, Install-Package instala a versão mais recente do pacote que satisfaz qualquer versão especificada pelo parâmetro MaximumVersion .

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. Vários nomes de pacotes têm de ser separados por vírgulas.

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

-NoPathUpdate

NoPathUpdate aplica-se apenas ao Install-Script cmdlet . NoPathUpdate é um parâmetro dinâmico adicionado pelo fornecedor e não é suportado pelo Install-Package.

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

-PackageManagementProvider

Especifica o nome do fornecedor PackageManagement .

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 para os quais pretende definir o âmbito da pesquisa do pacote. Pode obter nomes de fornecedores de pacotes ao executar o Get-PackageProvider cmdlet .

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

Especifica um servidor proxy para o pedido, em vez de ligar diretamente a um recurso da Internet.

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

-ProxyCredential

Especifica uma conta de utilizador que tem permissão para utilizar o servidor proxy especificado pelo parâmetro Proxy .

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

-PublishLocation

Especifica o caminho para a localização publicada de um pacote.

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

-RequiredVersion

Especifica a versão exata permitida do pacote que pretende instalar. Se não adicionar este parâmetro, Install-Package instala a versão mais recente do pacote que satisfaz qualquer versão especificada pelo parâmetro MaximumVersion .

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

-RoleCapability

Especifica uma matriz de capacidades de função.

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

-Scope

Especifica o âmbito para o qual instalar o pacote. Os valores aceitáveis para este parâmetro são os seguintes:

• CurrentUser
• AllUsers

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

-ScriptPublishLocation

Especifica o caminho para a localização publicada de um script.

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

-ScriptSourceLocation

Especifica a localização da origem do script.

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

-SkipDependencies

Ignora a instalação de dependências de software.

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

-SkipValidate

Alternância que ignora a validação das credenciais de um pacote.

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

-Source

Especifica uma ou mais origens de pacote. Vários nomes de origem de pacotes têm de ser separados por vírgulas. Pode obter nomes de origem de pacotes ao executar o Get-PackageSource cmdlet.

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

-Tag

Especifica uma ou mais cadeias de carateres a procurar nos metadados do pacote.

Type:	String[]
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 ambos. Os valores aceitáveis para este parâmetro são os seguintes:

• Módulo
• Script
• Todos

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

-WhatIf

Mostra o que aconteceria se Install-Package o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Pode encaminhar um objeto SoftwareIdentity para este cmdlet.

Saídas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Este cmdlet devolve um objeto SoftwareIdentity para cada pacote que instalar.

Notas

A inclusão de 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, Install-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.

Ligações Relacionadas

• about_PackageManagement
• Find-DscResource
• Get-Help
• Get-Package
• Get-PackageProvider
• Get-PackageSource
• Find-Package
• Save-Package
• Uninstall-Package