Partilhar via

Install-PackageProvider

  • Referência
Módulo:
PackageManagement

Instala um ou mais fornecedores de pacotes de Gestão 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 fornecedores de Gestão de Pacotes correspondentes que estão disponíveis em origens de pacotes registadas no PowerShellGet. Por predefinição, isto inclui módulos disponíveis na Galeria de Windows PowerShell com a etiqueta PackageManagement. O fornecedor de Gestão de Pacotes do PowerShellGet é utilizado para localizar fornecedores nestes repositórios.

Este cmdlet também instala fornecedores de Gestão de Pacotes correspondentes que estão disponíveis com a aplicação bootstrapping da Gestão de Pacotes.

Este cmdlet também instala fornecedores de Gestão de Pacotes correspondentes que estão disponíveis no arquivo de Blobs do Azure de Gestão de Pacotes. Utilize o fornecedor bootstrapper para localizá-los e instalá-los.

Para executar pela primeira vez, o PackageManagement requer uma ligação à Internet para transferir o fornecedor de pacotes NuGet. No entanto, se o seu computador não tiver uma ligação à Internet e precisar de utilizar o fornecedor NuGet ou PowerShellGet, pode transferi-los noutro computador e copiá-los para o computador de destino. Utilize os seguintes passos para o fazer:

  1. Execute Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force para instalar o fornecedor a partir de um computador com uma ligação à Internet.
  2. Após a instalação, pode encontrar o fornecedor instalado no $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> ou $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>no .
  3. Coloque a <ProviderName> pasta, que neste caso é a pasta NuGet, na localização correspondente no computador de destino. Se o computador de destino for um servidor Nano, terá de executar Install-PackageProvider a partir do Servidor Nano para transferir os binários NuGet corretos.
  4. Reinicie o PowerShell para carregar automaticamente o fornecedor de pacotes. Em alternativa, execute Get-PackageProvider -ListAvailable para listar todos os fornecedores de pacotes disponíveis no computador. Em seguida, utilize Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 para importar o fornecedor para a sessão de Windows PowerShell atual.

Exemplos

Exemplo 1: Instalar um fornecedor de pacotes a partir do Galeria do PowerShell

Este comando instala o fornecedor de pacotes GistProvider a partir do Galeria do PowerShell.

Install-PackageProvider -Name "GistProvider" -Verbose

Exemplo 2: Instalar uma versão especificada de um fornecedor de pacotes

Este exemplo instala uma versão especificada do fornecedor de pacotes NuGet.

O primeiro comando localiza todas as versões do fornecedor de pacotes com o nome NuGet. O segundo comando instala uma versão especificada do fornecedor de pacotes NuGet.

Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force

Exemplo 3: localizar um fornecedor e instalá-lo

Este exemplo utiliza Find-PackageProvider e o pipeline para procurar o fornecedor Gist e instalá-lo.

Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose

Exemplo 4: Instalar um fornecedor na pasta do módulo do utilizador atual

Este comando instala um fornecedor de pacotes para $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies que apenas o utilizador atual o possa utilizar.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

Parâmetros

-AllVersions

Indica que este cmdlet instala todas as versões disponíveis do fornecedor de pacotes. Por predefinição, Install-PackageProvider só devolve a versão mais elevada disponível.

Type:SwitchParameter
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

-Credential

Especifica uma conta de utilizador que tem permissão para instalar fornecedores de pacotes.

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

-Force

Indica que este cmdlet força todas as ações com este cmdlet que pode ser forçado. Atualmente, isto significa que o parâmetro Force age 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 este cmdlet instala automaticamente o fornecedor de pacotes.

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

-InputObject

Especifica um objeto SoftwareIdentity . Utilize o Find-PackageProvider cmdlet para obter um objeto SoftwareIdentity para encaminhar para Install-PackageProvider.

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 fornecedor de pacotes que pretende instalar. Se não adicionar este parâmetro, Install-PackageProvider o instala a versão mais elevada disponível do fornecedor.

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 fornecedor de pacotes que pretende instalar. Se não adicionar este parâmetro, Install-PackageProvider instala a versão mais elevada disponível do pacote que também satisfaz 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ódulos de fornecedor de pacotes. Separe vários nomes de pacotes com vírgulas. Os carateres universais não são suportados.

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

-Proxy

Especifica um servidor proxy para o pedido, em vez de ligar 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 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

-RequiredVersion

Especifica a versão exata permitida do fornecedor de pacotes que pretende instalar. Se não adicionar este parâmetro, Install-PackageProvider instala a versão mais elevada disponível do fornecedor que também satisfaz 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 âmbito de instalação do fornecedor. Os valores aceitáveis para este parâmetro são:

  • AllUsers – instala fornecedores numa localização acessível a todos os utilizadores do computador. Por predefinição, é $env:ProgramFiles\PackageManagement\ProviderAssemblies.

  • CurrentUser – instala fornecedores numa localização onde só estão acessíveis ao utilizador atual. Por predefinição, é $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 origens de pacotes. Utilize o Get-PackageSource cmdlet para obter uma lista de origens de pacotes disponíveis.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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. Utilize Find-PackageProvider para obter um objeto SoftwareIdentity que pode ser direcionado para Install-PackageProvidero .

Notas

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.