Install-PackageProvider
Instala um ou mais provedores de pacotes de Gerenciamento de Pacotes.
Sintaxe
PackageBySearch (Predefinição)
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>]
PackageByInputObject
Install-PackageProvider
[-InputObject] <SoftwareIdentity[]>
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O Install-PackageProvider cmdlet instala provedores de Gerenciamento de Pacotes correspondentes que estão disponíveis em fontes de pacotes registradas com PowerShellGet. Por padrão, isso inclui módulos disponíveis na Galeria do Windows PowerShell com a marca PackageManagement . O provedor PowerShellGet Package Management é usado para localizar provedores nesses repositórios.
Este cmdlet também instala provedores de Gerenciamento de Pacotes correspondentes que estão disponíveis usando o aplicativo de inicialização do Gerenciamento de Pacotes.
Exemplos
Exemplo 1: Instalar um provedor de pacotes a partir da Galeria do PowerShell
Este comando instala o provedor de pacotes GistProvider da 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
Você 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: Encontre um provedor e instale-o
Este exemplo usa Find-PackageProvider e o pipeline para procurar o provedor Gist e instalá-lo.
Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose
Exemplo 4: Instalar um provedor na pasta do módulo do usuário atual
Este comando instala um provedor de pacotes para $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies que 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Especifica uma conta de usuário que tem permissão para instalar provedores de pacotes.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PackageBySearch
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Indica que esse cmdlet força todas as ações com ele que podem ser forçadas. Atualmente, isso significa que o parâmetro Force atua da mesma forma que o parâmetro ForceBootstrap .
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ForceBootstrap
Indica que esse cmdlet instala automaticamente o provedor de pacotes.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Especifica um objeto SoftwareIdentity . Use o Find-PackageProvider cmdlet para obter um objeto SoftwareIdentity para canalizar para Install-PackageProvidero .
Propriedades dos parâmetros
| Tipo: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PackageByInputObject
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PackageBySearch
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 satisfaça qualquer requisito especificado pelo parâmetro MaximumVersion .
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PackageBySearch
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica um ou mais nomes de módulo do provedor de pacotes. Separe vários nomes de pacotes com vírgulas. Não há suporte para caracteres curinga.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PackageBySearch
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Proxy
Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente ao recurso da Internet.
Propriedades dos parâmetros
| Tipo: | Uri |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ProxyCredential
Especifica uma conta de usuário que tem permissão para usar o servidor proxy especificado pelo parâmetro Proxy.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RequiredVersion
Especifica a versão permitida exata 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 satisfaz qualquer versão máxima especificada pelo parâmetro MaximumVersion .
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PackageBySearch
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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ó são acessíveis ao usuário atual. Por padrão, isso é $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Valores aceites: | CurrentUser, AllUsers |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Source
Especifica uma ou mais fontes de pacote. Use o Get-PackageSource cmdlet para obter uma lista de fontes de pacotes disponíveis.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
PackageBySearch
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
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-PackageProvidero .
Notas
Importante
A partir de abril de 2020, a Galeria do PowerShell não suporta mais as versões 1.0 e 1.1 do Transport Layer Security (TLS). 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 de anúncio de
