Save-Module

Modulo:

PowerShellGet Module

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

Sintassi

NameAndPathParameterSet (Impostazione predefinita)

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

NameAndLiteralPathParameterSet

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

InputObjectAndLiteralPathParameterSet

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

InputObjectAndPathParameterSet

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

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

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-AllowPrerelease

Consente di salvare un modulo contrassegnato come versione preliminare.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

NameAndPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

NameAndLiteralPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Confirm

Richiede conferma prima di eseguire il Save-Module.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	cfr

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Credential

Specifica un account utente con diritti per salvare un modulo.

Proprietà dei parametri

Tipo:	PSCredential
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	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.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-InputObject

Accetta un oggetto PSRepositoryItemInfo . Ad esempio, restituire Find-Module una variabile e usare tale variabile come argomento InputObject .

Proprietà dei parametri

Tipo:	PSObject[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

InputObjectAndLiteralPathParameterSet

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

InputObjectAndPathParameterSet

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	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.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	PSPath

Set di parametri

NameAndLiteralPathParameterSet

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

InputObjectAndLiteralPathParameterSet

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	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.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

NameAndPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

NameAndLiteralPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	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.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

NameAndPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

NameAndLiteralPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Name

Specifica una matrice di nomi di moduli da salvare.

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

NameAndPathParameterSet

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

NameAndLiteralPathParameterSet

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Path

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

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	True
DontShow:	False

Set di parametri

NameAndPathParameterSet

Posizione:	1
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

InputObjectAndPathParameterSet

Posizione:	1
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Proxy

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

Proprietà dei parametri

Tipo:	Uri
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-ProxyCredential

Specifica un account utente autorizzato a usare il server proxy specificato dal parametro Proxy .

Proprietà dei parametri

Tipo:	PSCredential
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Repository

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

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

NameAndPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

NameAndLiteralPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-RequiredVersion

Specifica il numero di versione esatto del modulo da salvare.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

NameAndPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

NameAndLiteralPathParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-WhatIf

Mostra cosa accadrebbe se il Save-Module venisse eseguito. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Wi

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

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 Transport Layer Security (TLS). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si prova ad accedere a PowerShell Gallery. Usare il comando seguente per assicurarsi di usare TLS 1.2:

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

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