Save-Module
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 PowerShellGetSave-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.0Save-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.5Find-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[]
Sorties
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour