Partilhar via

Download Manual do Pacote

  • Artigo

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

Observação

O download manual do pacote não se destina substituir o cmdlet Install-Module. O download do 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 que se seguem são fornecidas apenas para fins de referência.

Usando o download manual para adquirir um pacote

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

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

Para fazer o download manualmente, clique em Baixe o arquivo raw nupkg. Uma cópia do pacote é copiada para a pasta de download do seu 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 a partir de um pacote NuGet

Observação

Estas instruções NÃO dar o mesmo resultado que executar Install-Module. Estas instruções cumprem os 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 do pacote NuGet (.nupkgbaixado pela Internet, 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 estiver marcado como uma versão de pré-lançamento. Renomeie a pasta para apenas o nome do módulo. Por exemplo, azurerm.storage.5.0.4-preview torna-se azurerm.storage.
  5. Copie a pasta para uma das pastas no $env:PSModulePath value. $env:PSModulePath é um conjunto de caminhos delimitado por ponto-e-vírgula no qual 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, elas devem ser instaladas 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 a partir de um pacote NuGet

Observação

Estas instruções NÃO dar o mesmo resultado que executar Install-Script. Estas instruções cumprem os 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 do pacote NuGet (.nupkgbaixado pela Internet, 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 deste 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, elas devem ser instaladas no sistema para que este módulo funcione corretamente. A Galeria do PowerShell mostra todas as dependências exigidas pelo pacote.