Atualizar o PowerShellGet para Windows PowerShell 5.1

Windows PowerShell 5.1 inclui a versão 1.0.0.1 do PowerShellGet e PackageManagement pré-instalada. Esta versão do PowerShellGet tem funcionalidades limitadas e tem de ser atualizada para funcionar com o Galeria do PowerShell. Para ser suportado, tem de atualizar para a versão mais recente.

Pré-requisitos

• O PowerShellGet requer .NET Framework 4.5 ou superior. Para obter mais informações, consulte Instalar o .NET Framework para programadores.

• Para aceder ao Galeria do PowerShell, tem de utilizar o Transport Layer Security (TLS) 1.2 ou superior. Utilize o seguinte comando para ativar o TLS 1.2 na 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 está configurado para cada sessão do PowerShell. Para obter mais informações sobre perfis, consulte about_Profiles.

Instalar a versão mais recente do PowerShellGet

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

• Install-Module instala a versão mais recente (sem 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 for mais recente do que o módulo atualmente instalado. No entanto, este cmdlet só funciona se a versão anterior tiver sido instalada com Install-Module.

Para atualizar o módulo pré-instalado, tem de utilizar Install-Module. Depois de instalar a nova versão a partir do Galeria do PowerShell, pode utilizar Update-Module para instalar versões mais recentes.

Windows PowerShell 5.1 vem com o PowerShellGet versão 1.0.0.1, que não inclui o fornecedor NuGet. O fornecedor é obrigatório pelo PowerShellGet ao trabalhar com o Galeria do PowerShell.

Nota

Os seguintes comandos têm de ser executados a partir de uma sessão elevada do PowerShell. Clique com o botão direito do rato no ícone do PowerShell e selecione Executar como administrador para iniciar uma sessão elevada.

Existem duas formas de instalar o fornecedor NuGet:

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

  Execute o seguinte comando para instalar o fornecedor NuGet.

  Install-PackageProvider -Name NuGet -Force
  

  Depois de instalar o fornecedor, deverá poder utilizar qualquer um dos cmdlets do PowerShellGet com o Galeria do PowerShell.

• Deixe-o Install-Module pedir para instalar o fornecedor NuGet

  O comando seguinte tenta instalar o módulo do PowerShellGet atualizado sem o fornecedor NuGet.

  Install-Module PowerShellGet -AllowClobber -Force
  

  Install-Module pede-lhe para instalar o fornecedor NuGet. Escreva Y para instalar o fornecedor.

  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, deverá abrir uma nova sessão do PowerShell. O PowerShell carrega automaticamente a versão mais recente do módulo quando utiliza um cmdlet PowerShellGet .

Também recomendamos que registe o Galeria do PowerShell como um repositório fidedigno. Utilize o seguinte comando:

Set-PSRepository -Name PSGallery -InstallationPolicy Trusted

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