Save-Module

  • Riferimento
Modulo:
PowerShellGet

Salva un modulo e le relative dipendenze nel computer locale, ma non installa il modulo.

Sintassi

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>]

Descrizione

Il Save-Module cmdlet scarica un modulo e le dipendenze da un repository registrato. Save-Module scarica e salva la versione più recente di un modulo. I file vengono salvati in un percorso specificato nel computer locale. Il modulo non è installato, ma il contenuto è disponibile per l'ispezione da parte di un amministratore. Il modulo salvato può quindi essere copiato nella posizione appropriata $env:PSModulePath del computer offline.

Questo è un cmdlet proxy per il Save-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Per altre informazioni, vedere Save-PSResource

Esempio

Esempio 1: Salvare un modulo

In questo esempio un modulo e le relative dipendenze vengono salvati nel computer locale.

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 il parametro Name per specificare il modulo PowerShellGet. Il parametro Path specifica dove archiviare il modulo scaricato. Il parametro Repository specifica un repository registrato, PSGallery. Al termine del download, Get-ChildItem visualizza il contenuto del percorso in cui vengono archiviati i file.

Esempio 2: Salvare una versione specifica di un modulo

In questo esempio viene illustrato come usare un parametro come MaximumVersion o RequiredVersion per specificare una versione del modulo.

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 il parametro Name per specificare il modulo PowerShellGet. Il parametro Path specifica dove archiviare il modulo scaricato. Il parametro Repository specifica un repository registrato, PSGallery. MaximumVersion specifica che la versione 2.1.0 viene scaricata e salvata. Al termine del download, Get-ChildItem visualizza il contenuto del percorso in cui vengono archiviati i file.

Esempio 3: Trovare e salvare una versione specifica di un modulo

In questo esempio viene trovata una versione del modulo necessaria nel repository e salvata nel computer locale.

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 il parametro Name per specificare il modulo PowerShellGet. Il parametro Repository specifica un repository registrato, PSGallery. RequiredVersion specifica la versione 1.6.5.

L'oggetto viene inviato alla pipeline a Save-Module. Il parametro Path specifica dove archiviare il modulo scaricato. Al termine del download, Get-ChildItem visualizza il contenuto del percorso in cui vengono archiviati i file.

Parametri

-AcceptLicense

Il cmdlet proxy ignora questo parametro perché non è supportato da Save-PSResource.

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

-AllowPrerelease

Consente di salvare un modulo contrassegnato come versione preliminare.

Il cmdlet proxy esegue il mapping di questo parametro al parametro Prerelease di Save-PSResource.

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

-Confirm

Richiede la conferma prima di eseguire .Save-Module

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

-Credential

Specifica un account utente con diritti per salvare un modulo.

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

-Force

Il cmdlet proxy ignora questo parametro perché non è supportato da Save-PSResource.

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

-InputObject

Accetta un oggetto PSRepositoryItemInfo . Ad esempio, l'output Find-Module in una variabile e l'uso di tale variabile come argomento InputObject .

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

-LiteralPath

Specifica un percorso di una o più posizioni. Il valore del parametro LiteralPath viene usato esattamente come immesso. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderli tra virgolette singole. PowerShell non interpreta i caratteri racchiusi tra virgolette singole come sequenze di escape.

Il cmdlet proxy esegue il mapping di questo parametro al parametro Path di Save-PSResource.

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

-MaximumVersion

Il cmdlet proxy usa il valore di questo parametro per creare una stringa di ricerca della versione NuGet da usare con il parametro Version di Save-PSResource.

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

-MinimumVersion

Il cmdlet proxy usa il valore di questo parametro per creare una stringa di ricerca della versione NuGet da usare con il parametro Version di Save-PSResource.

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

-Name

Specifica una matrice di nomi di moduli da salvare.

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

-Path

Specifica il percorso nel computer locale per archiviare un modulo salvato. Accetta caratteri jolly.

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

-Proxy

Il cmdlet proxy ignora questo parametro perché non è supportato da Save-PSResource.

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

-ProxyCredential

Il cmdlet proxy ignora questo parametro perché non è supportato da Save-PSResource.

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

-Repository

Specifica il nome descrittivo di un repository registrato eseguendo Register-PSRepository. Usare Get-PSRepository per visualizzare i repository registrati.

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

-RequiredVersion

Il cmdlet proxy usa il valore di questo parametro per creare una stringa di ricerca della versione NuGet da usare con il parametro Version di Save-PSResource.

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

-WhatIf

Mostra cosa succederebbe se l'esecuzione.Save-Module Il cmdlet non viene eseguito.

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

Input

String[]

PSObject[]

String

Uri

PSCredential

Output

Object

Note

La PowerShell Gallery non supporta più Transport Layer Security (TLS) versioni 1.0 e 1.1. È necessario usare TLS 1.2 o versione successiva. Per verificare di usare TLS 1.2, eseguire il comando seguente:

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