Compartilhar via

Download manual do pacote

  • Artigo

A Galeria do PowerShell dá suporte ao download de um pacote diretamente do site, sem usar os cmdlets do PowerShellGet. Você pode baixar qualquer pacote como um arquivo de pacote NuGet (.nupkg), que você pode copiar para um repositório interno.

Nota

O download manual do pacote não é pretendido como uma substituição para o cmdlet Install-Module. Baixar o pacote não instala o módulo ou o script. As dependências não estão incluídas no pacote NuGet baixado. As instruções a seguir são fornecidas somente para fins de referência.

Usando o download manual para adquirir um pacote

Cada página tem um link para Download Manual, conforme mostrado aqui:

página de exibição do pacote com opções de instalação

Para baixar manualmente, clique em Baixar o arquivo nupkg bruto. Uma cópia do pacote é copiada para a pasta de download do navegador com o nome <name>.<version>.nupkg.

Um pacote NuGet é um arquivo ZIP com arquivos extras contendo informações sobre o conteúdo do pacote. Alguns navegadores, como o Internet Explorer, substituem automaticamente a extensão de arquivo .nupkg por .zip. Para expandir o pacote, renomeie o arquivo .nupkg para .zip, se necessário, e extraia o conteúdo para uma pasta local usando Expand-Archive ou alguma outra ferramenta de arquivo ZIP.

Um arquivo de pacote NuGet inclui os seguintes elementos específicos do NuGet que não fazem parte do código empacotado original:

  • Uma pasta chamada _rels - contém um arquivo .rels que lista as dependências
  • Uma pasta chamada package – contém os dados específicos do NuGet
  • Um arquivo chamado [Content_Types].xml – descreve como extensões como o PowerShellGet funcionam com o NuGet
  • Um arquivo chamado <name>.nuspec - contém a maior parte dos metadados

Instalando módulos do PowerShell de um pacote NuGet

Nota

Estas instruções NÃO dar o mesmo resultado da execução Install-Module. Essas instruções atendem aos requisitos mínimos. Eles não se destinam a ser um substituto para Install-Module. Algumas etapas executadas por Install-Module não estão incluídas.

A abordagem mais fácil é remover os elementos específicos do NuGet da pasta. A remoção dos elementos deixa o código do PowerShell criado pelo autor do pacote. Para obter a lista de elementos específicos do NuGet, consulte Usando o download manual para adquirir um pacote.

As etapas são as seguintes:

  1. Desbloqueie o arquivo nuGet baixado pela Internet (.nupkg), por exemplo, usando Unblock-File -Path C:\Downloads\module.nupkg cmdlet.
  2. Extraia o conteúdo do pacote NuGet para uma pasta local.
  3. Exclua os elementos específicos do NuGet da pasta.
  4. Renomeie a pasta. O nome da pasta padrão geralmente é <name>.<version>. A versão pode incluir -prerelease se o módulo for marcado como uma versão de pré-lançamento. Renomeie a pasta apenas para o nome do módulo. Por exemplo, azurerm.storage.5.0.4-preview se torna azurerm.storage.
  5. Copie a pasta para uma das pastas no $env:PSModulePath value. $env:PSModulePath é um conjunto delimitado por ponto-e-vírgula de caminhos nos quais o PowerShell deve procurar módulos.

Importante

O download manual não inclui nenhuma dependência exigida pelo módulo. Se o pacote tiver dependências, eles deverão ser instalados no sistema para que este módulo funcione corretamente. A Galeria do PowerShell mostra todas as dependências exigidas pelo pacote.

Instalando scripts do PowerShell de um pacote NuGet

Nota

Estas instruções NÃO dar o mesmo resultado da execução Install-Script. Essas instruções atendem aos requisitos mínimos. Eles não se destinam a ser um substituto para Install-Script.

A abordagem mais fácil é extrair o pacote NuGet e, em seguida, usar o script diretamente.

As etapas são as seguintes:

  1. Desbloqueie o arquivo nuGet baixado pela Internet (.nupkg), por exemplo, usando Unblock-File -Path C:\Downloads\package.nupkg cmdlet.
  2. Extraia o conteúdo do pacote NuGet.
  3. O arquivo .PS1 na pasta pode ser usado diretamente desse local.
  4. Você pode excluir os elementos específicos do NuGet na pasta.

Para obter a lista de elementos específicos do NuGet, consulte Usando o download manual para adquirir um pacote.

Importante

O download manual não inclui nenhuma dependência exigida pelo módulo. Se o pacote tiver dependências, eles deverão ser instalados no sistema para que este módulo funcione corretamente. A Galeria do PowerShell mostra todas as dependências exigidas pelo pacote.