Install-PackageProvider

  • Referência
Módulo:
PackageManagement

Instala um ou mais provedores de pacotes de Gerenciamento de Pacotes.

Syntax

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 de 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 Pacote correspondentes que estão disponíveis usando o aplicativo de inicialização gerenciamento de pacotes.

Esse cmdlet também instala provedores de Gerenciamento de Pacotes correspondentes que estão disponíveis no repositório de Blobs do Azure de Gerenciamento de Pacotes. Use o provedor bootstrapper para encontrá-los e instalá-los.

Para executar a primeira vez, PackageManagement requer uma conexão com a Internet para baixar o provedor de pacotes NuGet. No entanto, se o computador não tiver uma conexão com a Internet e você precisar usar o provedor NuGet ou PowerShellGet, poderá baixá-los em outro computador e copiá-los para o computador de destino. Use as seguintes etapas para fazer isso:

  1. Execute Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force para instalar o provedor de um computador com uma conexão com a Internet.
  2. Após a instalação, você pode encontrar o provedor instalado em $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> ou $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>.
  3. Coloque a <ProviderName> pasta , que nesse caso é a pasta NuGet, no local correspondente no computador de destino. Se o computador de destino for um servidor Nano, você precisará executar Install-PackageProvider no Nano Server para baixar os binários NuGet corretos.
  4. Reinicie o PowerShell para carregar automaticamente o provedor de pacotes. Como alternativa, execute Get-PackageProvider -ListAvailable para listar todos os provedores de pacotes disponíveis no computador. Em seguida, use Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 para importar o provedor para a sessão de Windows PowerShell atual.

Exemplos

Exemplo 1: instalar um provedor de pacotes do Galeria do PowerShell

Esse comando instala o provedor de pacotes GistProvider do Galeria do PowerShell.

Install-PackageProvider -Name "GistProvider" -Verbose

Exemplo 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" -Force

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

Exemplo 4: Instalar um provedor na pasta de módulo do usuário atual

Esse comando instala um provedor de pacotes para que $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies apenas o usuário atual possa usá-lo.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

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

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

-Confirm

Solicita 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

-Credential

Especifica uma conta de usuário que tem permissão para instalar provedores de pacotes.

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

-Force

Indica que esse cmdlet força todas as ações com esse cmdlet que pode ser forçado. Atualmente, isso significa que o parâmetro Force atua da mesma forma que o parâmetro ForceBootstrap .

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

-ForceBootstrap

Indica que esse cmdlet instala automaticamente o provedor de pacotes.

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

-InputObject

Especifica um objeto SoftwareIdentity . Use o Find-PackageProvider cmdlet para obter um objeto SoftwareIdentity para redirecionar Install-PackageProviderpara .

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Proxy

Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente ao 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 usuário com permissão para conectar-se aos computadores especificados pelo parâmetro Proxy.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 atende a qualquer versão máxima especificada pelo parâmetro MaximumVersion .

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

-Scope

Especifica o escopo de instalação do provedor. Os valores aceitáveis para esse 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 em que eles só podem ser acessados pelo usuário atual. Por padrão, isso é $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.

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

-Source

Especifica uma ou mais fontes de pacote. Use o Get-PackageSource cmdlet para obter uma lista de fontes de pacote disponíveis.

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

-WhatIf

Mostra o que aconteceria se 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

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 dará mais suporte às versões 1.0 e 1.1 do protocolo TLS. Se você não estiver usando o TLS 1.2 ou posterior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que esteja usando o TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Para obter mais informações, confira o comunicado no blog do PowerShell.