O cmdlet Save-Module baixa um módulo e quaisquer dependências de um repositório registrado.
Save-Module baixa e salva a versão mais atual de um módulo. Os arquivos são salvos em um caminho especificado no computador local. O módulo não está instalado, mas o conteúdo está disponível para inspeção por um administrador. Em seguida, o módulo salvo pode ser copiado para o local apropriado $env:PSModulePath do computador offline.
Get-PSRepository exibe os repositórios registrados do computador local. Você pode usar o cmdlet Find-Module para pesquisar repositórios registrados.
Exemplos
Exemplo 1: salvar um módulo
Neste exemplo, um módulo e suas dependências são salvos no computador local.
Save-Module usa o parâmetro Name para especificar o módulo, do PowerShellGet. O parâmetro Path especifica onde armazenar o módulo baixado. O parâmetro Repositório especifica um repositório registrado, PSGallery. Depois que o download for concluído, Get-ChildItem exibirá o conteúdo de Path em que os arquivos são armazenados.
Exemplo 2: salvar uma versão específica de um módulo
Este exemplo mostra como usar um parâmetro como MaximumVersionou RequiredVersion para especificar uma versão do módulo.
Save-Module usa o parâmetro Name para especificar o módulo, do PowerShellGet. O parâmetro Path especifica onde armazenar o módulo baixado. O parâmetro Repositório especifica um repositório registrado, PSGallery.
MaximumVersion especifica que a versão 2.1.0 seja baixada e salva. Depois que o download for concluído, Get-ChildItem exibirá o conteúdo de Path em que os arquivos são armazenados.
Exemplo 3: localizar e salvar uma versão específica de um módulo
Neste exemplo, uma versão de módulo necessária é encontrada no repositório e salva no computador local.
Find-Module usa o parâmetro Name para especificar o módulo, do PowerShellGet. O parâmetro Repositório especifica um repositório registrado, PSGallery.
RequiredVersion especifica a versão 1.6.5.
O objeto é enviado pelo pipeline para Save-Module. O parâmetro Path especifica onde armazenar o módulo baixado. Depois que o download for concluído, Get-ChildItem exibirá o conteúdo de Path em que os arquivos são armazenados.
Parâmetros
-AcceptLicense
Aceite automaticamente o contrato de licença se o pacote exigir.
Especifica um caminho para um ou mais locais. O valor do parâmetro LiteralPath é usado exatamente como inserido. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. O PowerShell não interpreta nenhum caractere entre aspas simples como sequências de escape.
Especifica a versão máxima ou mais recente do módulo a ser salva. Os parâmetros MaximumVersion e RequiredVersion não podem ser usados no mesmo comando.
Especifica a versão mínima de um único módulo a ser salva. Você não poderá adicionar esse parâmetro se estiver tentando instalar vários módulos. Os parâmetros MinimumVersion e RequiredVersion não podem ser usados no mesmo comando.
Especifica o nome amigável de um repositório que foi registrado executando Register-PSRepository. Use Get-PSRepository para exibir repositórios registrados.
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
A partir de abril de 2020, a Galeria do PowerShell não dá mais suporte ao TLS (Transport Layer Security) versões 1.0 e 1.1. Se você não estiver usando o TLS 1.2 ou superior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que você esteja usando o TLS 1.2: