Partager via

Save-PSResource

Module:
Microsoft.PowerShell.PSResourceGet Module

Enregistre les ressources (modules et scripts) à partir d’un référentiel inscrit sur l’ordinateur.

Syntaxe

IncludeXmlParameterSet (Par défaut) 

Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-Quiet]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AsNupkgParameterSet 

Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-Quiet]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet 

Save-PSResource
    [-InputObject] <PSResourceInfo[]>
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-Quiet]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cette applet de commande combine les fonctionnalités des applets de commande Save-Module et Save-Script de PowerShellGet v2. Save-PSResource télécharge une ressource à partir d’un référentiel inscrit vers un chemin d’accès spécifique sur l’ordinateur local. Par défaut, la ressource est enregistrée au format décompressé ou installé. Les scripts ou modules peuvent être exécutés à partir de l’emplacement enregistré. Il existe également une option permettant de télécharger la ressource au format .nupkg.

Exemples

Exemple 1

Télécharge le module Az à partir du référentiel de priorité la plus élevée et l’enregistre à l’emplacement actuel.

Save-PSResource -Name Az

Exemple 2

Télécharge le module Az à partir de PowerShell Gallery et l’enregistre à l’emplacement actuel.

Save-PSResource -Name Az -Repository PSGallery

Exemple 3

Télécharge le module Az à partir du référentiel de priorité la plus élevée et l’enregistre au format .nupkg à l’emplacement actuel.

Save-PSResource Az -AsNupkg

Exemple 4

Télécharge le module Az à partir du référentiel de priorité la plus élevée et inclut le fichier de métadonnées XML PowerShellGet.

Save-PSResource Az -IncludeXML

Paramètres

-AcceptLicense

Pour les modules qui nécessitent une licence, accepte automatiquement le contrat de licence pendant l’installation.

Ce paramètre a été ajouté dans PSResourceGet 1.1.0-rc1.

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

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

-AsNupkg

Enregistre la ressource sous la forme d’un fichier .nupkg.

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

Jeux de paramètres

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

-AuthenticodeCheck

Valide les fichiers signés et les fichiers catalogue de la ressource sur Windows.

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

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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

Informations d’identification facultatives utilisées lors de l’accès à un référentiel.

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é:False
Valeur des arguments restants:False

-IncludeXml

Inclut le xml de métadonnées PowerShellGet utilisé pour vérifier que PowerShellGet a installé un 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

Jeux de paramètres

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

-InputObject

Utilisé pour l’entrée de pipeline.

Propriétés des paramètres

Type:

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Ressource pour les parents

Jeux de paramètres

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

-Name

Nom d’une ou plusieurs ressources à installer.

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

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

-PassThru

Quand elle est spécifiée, génère un objet PSResourceInfo pour la ressource enregistré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

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

-Path

Spécifie le chemin d’accès dans lequel enregistrer la ressource. Si aucun chemin d’accès n’est fourni, la ressource est enregistrée dans le répertoire actif.

Propriétés des paramètres

Type:String
Valeur par défaut:current directory
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

-Prerelease

Quand elle est spécifiée, inclut des versions préliminaires dans les résultats de recherche retournés.

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:Avant-première

Jeux de paramètres

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

-Quiet

Supprime la sortie de la barre de progression.

Ce paramètre a été ajouté dans PSResourceGet 1.1.0-rc1.

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

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

-Repository

Spécifie un ou plusieurs noms de référentiels à rechercher. Si elle n’est pas spécifiée, la recherche inclut tous les référentiels inscrits, dans l’ordre de priorité (le plus élevé), jusqu’à ce qu’un référentiel soit trouvé qui contient le package. Les référentiels sont triés par priorité, puis par nom. Les valeurs Priorité inférieure ont une priorité plus élevée.

Lors de la recherche de ressources sur plusieurs référentiels, les applets de commande PSResourceGet recherchent les référentiels à l’aide de cet ordre de tri. Save-PSResource enregistre le premier package correspondant dans la liste triée des référentiels.

Le paramètre prend en charge le caractère générique *. Si vous spécifiez plusieurs référentiels, tous les noms doivent inclure ou omettre le caractère générique. Vous ne pouvez pas spécifier de combinaison de noms avec et sans 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

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

-SkipDependencyCheck

Ignore la vérification des dépendances de ressources. Seules les ressources trouvées sont installées. Aucune ressource de la ressource trouvée n’est installé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

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

-TemporaryPath

Spécifie le chemin d’accès pour installer temporairement la ressource avant l’enregistrement. Si aucun chemin temporaire n’est fourni, la ressource est temporairement installée dans le dossier temporaire de l’utilisateur actuel.

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

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

-TrustRepository

Supprimez les invites pour approuver le référentiel. L’invite à approuver le référentiel se produit uniquement si le référentiel n’est pas configuré comme approuvé.

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

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

-Version

Spécifie la version de la ressource à retourner. La valeur peut être une version exacte ou une plage de versions à l’aide de la syntaxe de contrôle de version NuGet.

Pour plus d’informations sur les plages de versions NuGet, consultez de contrôle de version du package.

PowerShellGet prend en charge toutes les versions inclusives minimum répertoriées dans la documentation de la plage de versions NuGet. L’utilisation de 1.0.0.0 car la version ne génère pas les versions 1.0.0.0 et ultérieures (plage inclusive minimale). Au lieu de cela, la valeur est considérée comme la version requise. Pour rechercher une plage inclusive minimale, utilisez [1.0.0.0, ] comme plage de versions.

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

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. 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

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Sorties

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Par défaut, l’applet de commande ne retourne aucun objet. Lorsque le paramètre PassThru est utilisé, l’applet de commande génère un objet PSResourceInfo pour la ressource enregistrée.

Notes

Le module se définit svres comme un alias pour Save-PSResource.