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.

Syntax

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O Save-Module cmdlet baixa um módulo e todas as 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 Find-Module cmdlet para pesquisar repositórios registrados.

Os parâmetros que recebem números de versão do módulo esperam cadeias de caracteres formatadas como números de versão.

Os números de versão padrão têm um formato em x.y.z que x, y e z são números
As versões de pré-lançamento têm um formato de x.y.z-<prerelease_label> onde a <prerelease_label> cadeia de caracteres é arbitrária atribuída a essa versão.

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 , PowerShellGet. O parâmetro Path especifica onde armazenar o módulo baixado. O parâmetro Repository especifica um repositório registrado, PSGallery. Depois que o download for concluído, Get-ChildItem exibirá o conteúdo de Caminho 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 MaximumVersion ou 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 , PowerShellGet. O parâmetro Path especifica onde armazenar o módulo baixado. O parâmetro Repository especifica um repositório registrado, PSGallery. MaximumVersion especifica que a versão 2.1.0 é baixada e salva. Depois que o download for concluído, Get-ChildItem exibirá o conteúdo de Caminho 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 , PowerShellGet. O parâmetro Repository 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 Caminho em que os arquivos são armazenados.

Parâmetros

-AcceptLicense

Aceite automaticamente o contrato de licença se o pacote exigir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPrerelease

Permite salvar um módulo marcado como pré-lançamento.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Especifica uma conta de usuário que tem direitos para salvar um módulo.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Se o local especificado pelo parâmetro Path não existir, o cmdlet retornará um erro. O uso do parâmetro Force cria o caminho de destino.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Aceita um objeto PSRepositoryItemInfo . Por exemplo, saída Find-Module para uma variável e use essa variável como o argumento InputObject .

Type:	PSObject[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LiteralPath

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.

Type:	String
Aliases:	PSPath
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Proxy

Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente ao recurso da Internet.

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ProxyCredential

Especifica uma conta de usuário com permissão para conectar-se aos computadores especificados pelo parâmetro Proxy.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Repository

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RequiredVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String[]

PSObject[]

String

Uri

PSCredential

Saídas

Object

Observações

Importante

A partir de abril de 2020, a Galeria do PowerShell não dará mais suporte às versões 1.0 e 1.1 do protocolo TLS. Se você não estiver usando o TLS 1.2 ou posterior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que esteja usando o TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Para obter mais informações, confira o comunicado no blog do PowerShell.

Compartilhar via