Install-PackageProvider
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:
- Execute
Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Forcepara instalar o provedor de um computador com uma conexão com a Internet. - 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>. - 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á executarInstall-PackageProviderno Nano Server para baixar os binários NuGet corretos. - Reinicie o PowerShell para carregar automaticamente o provedor de pacotes. Como alternativa, execute
Get-PackageProvider -ListAvailablepara listar todos os provedores de pacotes disponíveis no computador. Em seguida, useImport-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201para 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" -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" -ForceExemplo 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 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 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.
| 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.
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de