Save-Module
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 tutte 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 nel percorso appropriato $env:PSModulePath del computer offline.
Si tratta di 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 di Path in cui sono archiviati i file.
Esempio 2: Salvare una versione specifica di un modulo
Questo esempio illustra 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 di Path in cui sono archiviati i file.
Esempio 3: Trovare e salvare una versione specifica di un modulo
In questo esempio, una versione del modulo obbligatoria è disponibile 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 di Path in cui sono archiviati i file.
Parametri
-AcceptLicense
Il cmdlet proxy ignora questo parametro perché non è supportato da Save-PSResource.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire .Save-Module
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Credential
Specifica un account utente con diritti per salvare un modulo.
| Tipo: | PSCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Force
Il cmdlet proxy ignora questo parametro perché non è supportato da Save-PSResource.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-InputObject
Accetta un oggetto PSRepositoryItemInfo . Ad esempio, restituire Find-Module una variabile e usare tale variabile come argomento InputObject .
| Tipo: | PSObject[] |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-LiteralPath
Specifica un percorso per una o più posizioni. Il valore del parametro LiteralPath viene usato esattamente come immesso. Nessun carattere viene interpretato come metacaratteri. 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.
| Tipo: | String |
| Alias: | PSPath |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Name
Specifica una matrice di nomi di moduli da salvare.
| Tipo: | String[] |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Path
Specifica il percorso nel computer locale per archiviare un modulo salvato. Accetta caratteri jolly.
| Tipo: | String |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | True |
-Proxy
Il cmdlet proxy ignora questo parametro perché non è supportato da Save-PSResource.
| Tipo: | Uri |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-ProxyCredential
Il cmdlet proxy ignora questo parametro perché non è supportato da Save-PSResource.
| Tipo: | PSCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Repository
Specifica il nome descrittivo di un repository registrato eseguendo Register-PSRepository. Usare Get-PSRepository per visualizzare i repository registrati.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accadrebbe se il Save-Module venisse eseguito. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
String[]
PSObject[]
Output
Note
PowerShell Gallery non supporta più Transport Layer Security (TLS) versioni 1.0 e 1.1. È necessario usare TLS 1.2 o versione successiva. Usare il comando seguente per assicurarsi di usare TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
