Install-PackageProvider
Instala um ou mais provedores de pacotes de Gerenciamento de Pacotes.
Sintaxe
Install-PackageProvider
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Source <String[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Install-PackageProvider
[-Scope <String>]
[-InputObject] <SoftwareIdentity[]>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O Install-PackageProvider cmdlet instala provedores de Gerenciamento de Pacote correspondentes que estão disponíveis em fontes de pacote registradas com o PowerShellGet. Por padrão, isso inclui módulos disponíveis na Galeria do Windows PowerShell com a marca PackageManagement . O provedor de Gerenciamento de Pacotes do PowerShellGet é usado para localizar provedores nesses repositórios.
Esse cmdlet também instala provedores de Gerenciamento de Pacotes correspondentes que estão disponíveis usando o aplicativo de inicialização de Gerenciamento de Pacotes.
Exemplos
Exemplo 1: instalar um provedor de pacotes da Galeria do PowerShell
Esse comando instala o provedor de pacotes GistProvider da Galeria do PowerShell.
Install-PackageProvider -Name "GistProvider" -VerboseExemplo 2: instalar uma versão especificada de um provedor de pacotes
Este exemplo instala uma versão especificada do provedor de pacotes NuGet.
O primeiro comando localiza todas as versões do provedor de pacotes chamado NuGet. O segundo comando instala uma versão especificada do provedor de pacotes NuGet.
Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -ForceVocê só precisará instalar o provedor de pacotes NuGet se estiver executando o PackageManagement v1.1.0.0 no Windows PowerShell. As versões mais recentes do PowerShellGet e do PackageManagement incluem o provedor de pacotes NuGet por padrão.
Exemplo 3: localizar um provedor e instalá-lo
Este exemplo usa Find-PackageProvider e o pipeline para pesquisar o provedor Gist e instalá-lo.
Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -VerboseExemplo 4: instalar um provedor na pasta do módulo do usuário atual
Esse comando instala um provedor de pacotes para $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies que somente o usuário atual possa usá-lo.
Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUserParâmetros
-AllVersions
Indica que esse cmdlet instala todas as versões disponíveis do provedor de pacotes. Por padrão, Install-PackageProvider retorna apenas a versão mais alta disponível.
| Tipo: | SwitchParameter |
| 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 |
-Credential
Especifica uma conta de usuário que tem permissão para instalar provedores de pacotes.
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Force
Indica que esse cmdlet força todas as ações com esse cmdlet que podem ser forçadas. Atualmente, isso significa que o parâmetro Force age da mesma forma que o parâmetro ForceBootstrap .
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceBootstrap
Indica que esse cmdlet instala automaticamente o provedor de pacotes.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InputObject
Especifica um objeto SoftwareIdentity . Use o Find-PackageProvider cmdlet para obter um objeto SoftwareIdentity para fazer pipe em Install-PackageProvider.
| Tipo: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-MaximumVersion
Especifica a versão máxima permitida do provedor de pacotes que você deseja instalar. Se você não adicionar esse parâmetro, Install-PackageProvider instalará a versão mais alta disponível do provedor.
| 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 permitida do provedor de pacotes que você deseja instalar. Se você não adicionar esse parâmetro, Install-PackageProvider instalará a versão mais alta disponível do pacote que também atende a qualquer requisito especificado 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 módulo do provedor de pacotes. Separe vários nomes de pacote com vírgulas. Não há suporte para caracteres curinga.
| Tipo: | String[] |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Proxy
Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente ao 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 |
-RequiredVersion
Especifica a versão exata permitida do provedor de pacotes que você deseja instalar. Se você não adicionar esse parâmetro, Install-PackageProvider instalará a versão mais alta disponível do provedor que também atenderá a qualquer versão máxima 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 |
-Scope
Especifica o escopo de instalação do provedor. Os valores aceitáveis para este parâmetro são:
AllUsers – instala provedores em um local acessível a todos os usuários do computador. Por padrão, isso é $env:ProgramFiles\PackageManagement\ProviderAssemblies.
CurrentUser – instala provedores em um local onde eles só podem ser acessados pelo usuário atual. Por padrão, isso é $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.
| 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 |
-Source
Especifica uma ou mais fontes de pacote. Use o Get-PackageSource cmdlet para obter uma lista de fontes de pacote disponíveis.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se 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. Use Find-PackageProvider para obter um objeto SoftwareIdentity que pode ser canalizado para Install-PackageProvider.
Observações
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.
