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

Get-PSRepository visualizza i repository registrati del computer locale. È possibile usare il Find-Module cmdlet per eseguire ricerche nei repository registrati.

I parametri che accettano numeri di versione del modulo prevedono stringhe formattate come numeri di versione.

I numeri di versione standard hanno un formato in x.y.z cui x, y e z sono numeri
Le versioni non definitive hanno un formato in x.y.z-<prerelease_label> cui la <prerelease_label> stringa è arbitraria assegnata a tale versione.

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 sono archiviati i file.

Esempio 2: Salvare una versione specifica di un modulo

In questo esempio viene illustrato come usare un parametro, ad esempio 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 sono archiviati i file.

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

In questo esempio viene trovata una versione del modulo richiesta 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 sono archiviati i file.

Parametri

-AcceptLicense

Accettare automaticamente il contratto di licenza se il pacchetto lo richiede.

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.

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

-Confirm

Richiede 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

Se il percorso specificato dal parametro Path non esiste, il cmdlet restituisce un errore. L'uso del parametro Force crea il percorso di destinazione.

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

-InputObject

Accetta un oggetto PSRepositoryItemInfo . Ad esempio, restituire un output Find-Module in una variabile e usare 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.

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

-MaximumVersion

Specifica la versione massima o più recente del modulo da salvare. I parametri MaximumVersion e RequiredVersion non possono essere usati nello stesso comando.

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

-MinimumVersion

Specifica la versione minima di un singolo modulo da salvare. Non è possibile aggiungere questo parametro se si tenta di installare più moduli. I parametri MinimumVersion e RequiredVersion non possono essere usati nello stesso comando.

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 in cui 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

Specifica un server proxy per la richiesta, anziché connettersi direttamente alla risorsa Internet.

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

-ProxyCredential

Specifica un account utente con autorizzazioni per l'uso del server proxy specificato dal parametro Proxy.

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

Specifica il numero di versione esatto del modulo da salvare.

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

-WhatIf

Mostra cosa accadrebbe 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

Importante

A partire da aprile 2020 PowerShell Gallery non supporta più le versioni 1.0 e 1.1 di TLS (Transport Layer Security). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si tenta di accedere a PowerShell Gallery. Per verificare di usare TLS 1.2, eseguire il comando seguente:

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

Per altre informazioni, vedere l'annuncio corrispondente nel blog di PowerShell.

Condividi tramite