Partilhar via


Save-Module

Guarda um módulo e as respetivas 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 transfere um módulo e quaisquer dependências de um repositório registado. Save-Module transfere e guarda a versão mais atual de um módulo. Os ficheiros são guardados num caminho especificado no computador local. O módulo não está instalado, mas os conteúdos estão disponíveis para inspeção por um administrador. Em seguida, o módulo guardado pode ser copiado para a localização adequada $env:PSModulePath do computador offline.

Este é um cmdlet proxy para o Save-PSResource cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, veja Save-PSResource

Exemplos

Exemplo 1: Guardar um módulo

Neste exemplo, um módulo e as respetivas dependências são guardados 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 utiliza o parâmetro Nome para especificar o módulo PowerShellGet. O parâmetro Caminho especifica onde armazenar o módulo transferido. O parâmetro Repositório especifica um repositório registado, PSGallery. Após a conclusão da transferência, Get-ChildItem apresenta o conteúdo do Caminho onde os ficheiros são armazenados.

Exemplo 2: Guardar uma versão específica de um módulo

Este exemplo mostra como utilizar 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 utiliza o parâmetro Nome para especificar o módulo PowerShellGet. O parâmetro Caminho especifica onde armazenar o módulo transferido. O parâmetro Repositório especifica um repositório registado, PSGallery. MaximumVersion especifica que a versão 2.1.0 é transferida e guardada. Após a conclusão da transferência, Get-ChildItem apresenta o conteúdo do Caminho onde os ficheiros são armazenados.

Exemplo 3: localizar e guardar uma versão específica de um módulo

Neste exemplo, encontra-se uma versão do módulo necessária no repositório e guardada 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 utiliza o parâmetro Nome para especificar o módulo PowerShellGet. O parâmetro Repositório especifica um repositório registado, PSGallery. RequiredVersion especifica a versão 1.6.5.

O objeto é enviado pelo pipeline para Save-Module. O parâmetro Caminho especifica onde armazenar o módulo transferido. Após a conclusão da transferência, Get-ChildItem apresenta o conteúdo do Caminho onde os ficheiros são armazenados.

Parâmetros

-AcceptLicense

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Save-PSResource.

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

-AllowPrerelease

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

O cmdlet proxy mapeia este parâmetro para o parâmetro Pré-lançamento de Save-PSResource.

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

-Confirm

Pede-lhe 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 utilizador que tem direitos para guardar um módulo.

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

-Force

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Save-PSResource.

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

-InputObject

Aceita um objeto PSRepositoryItemInfo . Por exemplo, produza Find-Module para uma variável e utilize essa variável como argumento InputObject .

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

-LiteralPath

Especifica um caminho para uma ou mais localizações. O valor do parâmetro LiteralPath é utilizado exatamente como introduzido. Nenhum caráter é interpretado como carateres universais. Se o caminho incluir carateres de escape, coloque-os entre aspas. O PowerShell não interpreta quaisquer carateres entre aspas individuais como sequências de escape.

O cmdlet proxy mapeia este parâmetro para o parâmetro Caminho de Save-PSResource.

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

-MaximumVersion

O cmdlet proxy utiliza o valor deste parâmetro para criar uma cadeia de pesquisa de versão NuGet para utilização com o parâmetro Versão de Save-PSResource.

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

-MinimumVersion

O cmdlet proxy utiliza o valor deste parâmetro para criar uma cadeia de pesquisa de versão NuGet para utilização com o parâmetro Versão de Save-PSResource.

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 guardar.

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

-Path

Especifica a localização no computador local para armazenar um módulo guardado. Aceita carateres universais.

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

-Proxy

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Save-PSResource.

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

-ProxyCredential

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Save-PSResource.

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 registado ao executar Register-PSRepository. Utilizado Get-PSRepository para apresentar repositórios registados.

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

-RequiredVersion

O cmdlet proxy utiliza o valor deste parâmetro para criar uma cadeia de pesquisa de versão NuGet para utilização com o parâmetro Versão de Save-PSResource.

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

-WhatIf

Mostra o que aconteceria se as Save-Module execuções fossem executadas. 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

Notas

O Galeria do PowerShell já não suporta as versões 1.0 e 1.1 do Transport Layer Security (TLS). Tem de utilizar o TLS 1.2 ou superior. Utilize o seguinte comando para garantir que está a utilizar o TLS 1.2:

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