Compartilhar via


Atualização de PowerShellGet para Windows PowerShell 5.1

Windows PowerShell 5.1 vem com a versão 1.0.0.1 do PowerShellGet e PackageManagement pré-instalada. Esta versão do PowerShellGet tem recursos limitados e deve ser atualizada para funcionar com o Galeria do PowerShell. Para ter suporte, você precisa atualizar para a versão mais recente.

Pré-requisitos

  • O PowerShellGet requer o .NET Framework 4.5 ou posterior. Para obter mais informações, confira Instalar o .NET Framework para desenvolvedores.

  • Para acessar a Galeria do PowerShell, você precisa usar o protocolo TLS (Transport Layer Security) 1.2 ou superior. Use o comando a seguir para habilitar o TLS 1.2 na sua sessão do PowerShell.

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

    Adicione este comando ao script de perfil do PowerShell para garantir que o TLS 1.2 esteja configurado para cada sessão do PowerShell. Para obter mais informações sobre perfis, consulte about_Profiles.

Como instalar a versão mais recente do PowerShellGet

O módulo PowerShellGet inclui cmdlets para instalar e atualizar módulos:

  • O Install-Module instala a versão mais recente (não o pré-lançamento) de um módulo.
  • Update-Module instala a versão mais recente (não pré-lançamento) de um módulo se ela for mais recente do que o módulo atualmente instalado. No entanto, esse cmdlet só funcionará se a versão anterior tiver sido instalada usando o Install-Module.

Para atualizar o módulo pré-instalado, você precisa usar Install-Module. Depois de instalar a nova versão na Galeria do PowerShell, você pode usar Update-Module para instalar versões mais recentes.

O Windows PowerShell 5.1 vem com o PowerShellGet versão 1.0.0.1, que não inclui o provedor de NuGet. O provedor é exigido pelo PowerShellGet ao trabalhar com a Galeria do PowerShell.

Observação

O comando a seguir precisa ser executado em uma sessão do PowerShell com privilégios elevados. Clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador para iniciar uma sessão com privilégios elevados.

Existem duas maneiras de instalar o provedor de NuGet:

  • Use o Install-PackageProvider para instalar o NuGet antes de instalar outros módulos

    Execute o comando a seguir para instalar o provedor de NuGet.

    Install-PackageProvider -Name NuGet -Force
    

    Depois de instalar o provedor, você poderá usar qualquer um dos cmdlets do PowerShellGet com a Galeria do PowerShell.

  • Permita que o Install-Module solicite a instalação do provedor de NuGet

    O comando a seguir tenta instalar o módulo do PowerShellGet atualizado sem o provedor de NuGet.

    Install-Module PowerShellGet -AllowClobber -Force
    

    O Install-Module solicita que você instale o provedor de NuGet. Digite Y para instalar o provedor.

    NuGet provider is required to continue
    PowerShellGet requires NuGet provider version '2.8.5.201' or newer to interact with NuGet-based
    repositories. The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies'
    or 'C:\Users\user1\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install the
    NuGet provider by running 'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force'.
    Do you want PowerShellGet to install and import the NuGet provider now?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
    VERBOSE: Installing NuGet provider.
    

Depois de instalar o PowerShellGet

Depois de instalar a nova versão do PowerShellGet, você deverá abrir uma nova sessão do PowerShell. O PowerShell carrega automaticamente a versão mais recente do módulo quando você usa um cmdlet do PowerShellGet.

Também recomendamos que você registre a Galeria do PowerShell como um repositório confiável. Use o seguinte comando:

Set-PSRepository -Name PSGallery -InstallationPolicy Trusted

Para obter mais informações, confira Set-PSRepository.