Save-Module

  • Référence
Module:
PowerShellGet

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

Syntax

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

Description

L’applet Save-Module de commande télécharge un module et toutes les dépendances à partir d’un dépôt 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 spécifié sur l’ordinateur local. Le module n’est pas installé, mais son contenu peut être inspecté par un administrateur. Le module enregistré peut ensuite être copié à l’emplacement approprié $env:PSModulePath de la machine hors connexion.

Il s’agit d’une applet de commande de proxy pour l’applet Save-PSResource de commande dans Microsoft.PowerShell.PSResourceGet. Pour plus d’informations, consultez Save-PSResource

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 dépôt inscrit, PSGallery. Une fois le téléchargement terminé, Get-ChildItem affiche le contenu du chemin d’accès où les fichiers sont stockés.

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 dépôt 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ù les fichiers sont stockés.

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

Dans cet exemple, une version de module requise est trouvée 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 dépôt inscrit, PSGallery. RequiredVersion spécifie la version 1.6.5.

L’objet est envoyé vers le bas du pipeline vers 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ù les fichiers sont stockés.

Paramètres

-AcceptLicense

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Save-PSResource.

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

-AllowPrerelease

Vous permet d’enregistrer un module marqué en tant que préversion.

L’applet de commande proxy mappe ce paramètre au paramètre Prerelease de Save-PSResource.

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

-Confirm

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

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

-Credential

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

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

-Force

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Save-PSResource.

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

-InputObject

Accepte un objet PSRepositoryItemInfo . Par exemple, effectuez une sortie Find-Module vers une variable et utilisez cette variable comme argument InputObject .

Type:PSObject[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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é. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin d’accès comprend des caractères d’échappement, placez-les entre guillemets simples. PowerShell n’interprète pas les caractères placés entre guillemets simples comme des séquences d’échappement.

L’applet de commande proxy mappe ce paramètre au paramètre Path de Save-PSResource.

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

-MaximumVersion

L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Save-PSResource.

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

-MinimumVersion

L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Save-PSResource.

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

-Name

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

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

-Path

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

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

-Proxy

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Save-PSResource.

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

-ProxyCredential

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Save-PSResource.

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

-Repository

Spécifie le nom convivial d’un dépôt qui a été inscrit en exécutant Register-PSRepository. Utilisez Get-PSRepository pour afficher les dépôts inscrits.

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

-RequiredVersion

L’applet de commande proxy utilise la valeur de ce paramètre pour créer une chaîne de recherche de version NuGet à utiliser avec le paramètre Version de Save-PSResource.

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

-WhatIf

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

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

Entrées

String[]

PSObject[]

String

Uri

PSCredential

Sorties

Object

Notes

Le PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Vous devez utiliser TLS 1.2 ou version ultérieure. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

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