Save-PSResource

  • Référence
Module:
Microsoft.PowerShell.PSResourceGet

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

Syntaxe

Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-PSResource
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-InputObject] <PSResourceInfo[]>
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-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.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AsNupkg

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

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AuthenticodeCheck

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

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

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

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

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

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IncludeXml

Inclut le xml de métadonnées PowerShellGet utilisé pour vérifier que PowerShellGet a installé un module.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Utilisé pour l’entrée de pipeline.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Alias:ParentResource
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Nom d’une ou plusieurs ressources à installer.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Quand elle est spécifiée, génère un objet PSResourceInfo pour la ressource enregistrée.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:String
Position:Named
Valeur par défaut:current directory
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Prerelease

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

Type:SwitchParameter
Alias:IsPrerelease
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Quiet

Supprime la sortie de la barre de progression.

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

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

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

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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é.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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.