Save-Module

Referência

Módulo:: PowershellGet

Salva um módulo e suas dependências no computador local, mas não instala o módulo.

Sintaxe

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <Version>]
    [-MaximumVersion <Version>]
    [-RequiredVersion <Version>]
    [-Repository <String[]>]
    -Path <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <Version>]
    [-MaximumVersion <Version>]
    [-RequiredVersion <Version>]
    [-Repository <String[]>]
    -LiteralPath <String>
    [-Force]
    [-WhatIf]
    [-Confirm] 
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    -Path <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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.

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 -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery
Get-ChildItem -Path C:\Test\Modules

Directory: C:\Test\Modules

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:31                PackageManagement
d-----         7/1/2019     13:31                PowerShellGet

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 -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery -MaximumVersion 2.1.0
Get-ChildItem -Path C:\Test\Modules\PowerShellGet\

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:40                2.1.0

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 -Name PowerShellGet -Repository PSGallery -RequiredVersion 1.6.5 |
  Save-Module -Path C:\Test\Modules
Get-ChildItem -Path C:\Test\Modules\PowerShellGet

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     14:04                1.6.5

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

-Confirm

Solicita a confirmação antes de executar o Save-Module.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Force

Força Save-Module a executar sem solicitar a confirmação do usuário.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Aceita um objeto PSRepositoryItemInfo . Por exemplo, a saída para uma variável e usar essa variável como o argumento InputObject .

Tipo:	PSObject[]
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-LiteralPath

Especifica um caminho para um ou mais locais. O valor do parâmetro LiteralPath é usado exatamente como inserido. Nenhum caractere é interpretado como 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.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-MaximumVersion

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.

Tipo:	Version
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-MinimumVersion

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.

Tipo:	Version
Aliases:	Version
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

Especifica uma matriz de nomes de módulos a serem salvos.

Tipo:	String[]
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Path

Especifica o local no computador local para armazenar um módulo salvo. Aceita caracteres curinga.

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	True

-Repository

Especifica o nome amigável de um repositório que foi registrado executando Register-PSRepository. Use Get-PSRepository para exibir repositórios registrados.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-RequiredVersion

Especifica o número exato da versão do módulo a ser salvo.

Tipo:	Version
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o Save-Module fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Compartilhar via