Save-Module

Module:

PowerShellGet Module

Enregistre un module et ses dépendances sur l’ordinateur local, mais n’installe pas le module.

Syntaxe

NameAndPathParameterSet (Par défaut)

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

Description

L’applet Save-Module de commande télécharge un module et toutes les dépendances à partir d’un référentiel inscrit. Save-Module télécharge et enregistre la version la plus récente d’un module. Les fichiers sont enregistrés dans un chemin d’accès spécifié sur l’ordinateur local. Le module n’est pas installé, mais le contenu est disponible pour inspection par un administrateur. Le module enregistré peut ensuite être copié à l’emplacement approprié $env:PSModulePath de l’ordinateur hors connexion.

Get-PSRepository affiche les dépôts inscrits de l’ordinateur local. Vous pouvez utiliser l’applet Find-Module de commande pour rechercher des référentiels inscrits.

Les paramètres qui prennent les numéros de version du module s’attendent à ce que les chaînes mises en forme en tant que numéros de version.

• Les numéros de version standard ont un format où x.y.z x, y et z sont des nombres
• Les versions préliminaires ont un format où x.y.z-<prerelease_label> la <prerelease_label> chaîne arbitraire affectée à cette version est arbitraire.

Exemples

Exemple 1 : Enregistrer un module

Dans cet exemple, un module et ses dépendances sont enregistrés sur l’ordinateur 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 utilise le paramètre Name pour spécifier le module PowerShellGet. Le paramètre Path spécifie où stocker le module téléchargé. Le paramètre Repository spécifie un référentiel inscrit, PSGallery. Une fois le téléchargement terminé, Get-ChildItem affiche le contenu du chemin d’accès où sont stockés les fichiers.

Exemple 2 : Enregistrer une version spécifique d’un module

Cet exemple montre comment utiliser un paramètre tel que MaximumVersion ou RequiredVersion pour spécifier une version de module.

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 utilise le paramètre Name pour spécifier le module PowerShellGet. Le paramètre Path spécifie où stocker le module téléchargé. Le paramètre Repository spécifie un référentiel inscrit, PSGallery. MaximumVersion spécifie que la version 2.1.0 est téléchargée et enregistrée. Une fois le téléchargement terminé, Get-ChildItem affiche le contenu du chemin d’accès où sont stockés les fichiers.

Exemple 3 : Rechercher et enregistrer une version spécifique d’un module

Dans cet exemple, une version de module requise se trouve dans le référentiel et enregistrée sur l’ordinateur 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 utilise le paramètre Name pour spécifier le module PowerShellGet. Le paramètre Repository spécifie un référentiel inscrit, PSGallery. RequiredVersion spécifie la version 1.6.5.

L’objet est envoyé dans le pipeline à Save-Module. Le paramètre Path spécifie où stocker le module téléchargé. Une fois le téléchargement terminé, Get-ChildItem affiche le contenu du chemin d’accès où sont stockés les fichiers.

Paramètres

-AcceptLicense

Acceptez automatiquement le contrat de licence si le package l’exige.

Propriétés des paramètres

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AllowPrerelease

Vous permet d’enregistrer un module marqué comme une préversion.

Propriétés des paramètres

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

NameAndPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

Vous invite à confirmer avant d’exécuter le Save-Module.

Propriétés des paramètres

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Credential

Spécifie un compte d’utilisateur disposant des droits d’enregistrement d’un module.

Propriétés des paramètres

Type:	PSCredential
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Force

Si l’emplacement spécifié par le paramètre Path n’existe pas, l’applet de commande retourne une erreur. L’utilisation du paramètre Force crée le chemin d’accès cible.

Propriétés des paramètres

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-InputObject

Accepte un objet PSRepositoryItemInfo. Par exemple, sortie Find-Module à une variable et utiliser cette variable comme argument InputObject.

Propriétés des paramètres

Type:	PSObject[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

InputObjectAndLiteralPathParameterSet

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

InputObjectAndPathParameterSet

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-LiteralPath

Spécifie un chemin d’accès à un ou plusieurs emplacements. La valeur du paramètre LiteralPath est utilisée exactement comme entrée. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin inclut des caractères d’échappement, placez-les entre guillemets simples. PowerShell n’interprète aucun caractère entre guillemets simples comme séquences d’échappement.

Propriétés des paramètres

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	PSPath

Jeux de paramètres

NameAndLiteralPathParameterSet

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

InputObjectAndLiteralPathParameterSet

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-MaximumVersion

Spécifie la version maximale ou la plus récente du module à enregistrer. Les paramètres MaximumVersion et RequiredVersion ne peuvent pas être utilisés dans la même commande.

Propriétés des paramètres

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

NameAndPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-MinimumVersion

Spécifie la version minimale d’un seul module à enregistrer. Vous ne pouvez pas ajouter ce paramètre si vous tentez d’installer plusieurs modules. Les paramètres MinimumVersion et RequiredVersion ne peuvent pas être utilisés dans la même commande.

Propriétés des paramètres

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

NameAndPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Name

Spécifie un tableau de noms de modules à enregistrer.

Propriétés des paramètres

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

NameAndPathParameterSet

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

NameAndLiteralPathParameterSet

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Path

Spécifie l’emplacement sur l’ordinateur local pour stocker un module enregistré. Accepte les caractères génériques.

Propriétés des paramètres

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	True
DontShow:	False

Jeux de paramètres

NameAndPathParameterSet

Position:	1
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

InputObjectAndPathParameterSet

Position:	1
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Proxy

Spécifie un serveur proxy pour la requête, plutôt que de se connecter directement à la ressource Internet.

Propriétés des paramètres

Type:	Uri
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-ProxyCredential

Spécifie un compte d’utilisateur autorisé à utiliser le serveur proxy spécifié par le paramètre Proxy .

Propriétés des paramètres

Type:	PSCredential
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Repository

Spécifie le nom convivial d’un référentiel qui a été inscrit en exécutant Register-PSRepository. Permet Get-PSRepository d’afficher les référentiels inscrits.

Propriétés des paramètres

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

NameAndPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-RequiredVersion

Spécifie le numéro de version exact du module à enregistrer.

Propriétés des paramètres

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

NameAndPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-WhatIf

Montre ce qui se passerait si le Save-Module fonctionne. L’applet de commande n’est pas exécutée.

Propriétés des paramètres

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

PSObject

String

Uri

PSCredential

Sorties

Object

Notes

Important

Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Si vous n’utilisez pas TLS 1.2 ou version ultérieure, vous recevez une erreur lors de la tentative d’accès à PowerShell Gallery. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

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

Pour plus d’informations, consultez l’annonce dans le blog PowerShell.