Sync-Package (Console du Gestionnaire de package dans Visual Studio)

  • Article

Version 3.0+ ; disponible uniquement dans la console du Gestionnaire de package dans Visual Studio sous Windows.

Obtient la version du package installé à partir du projet spécifié (ou par défaut) et synchronise la version avec le reste des projets de la solution.

Syntaxe

Sync-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [[-Version] <string>]
    [[-Source] <string>] [-IncludePrerelease] [-FileConflictAction] [-DependencyVersion]
    [-WhatIf] [<CommonParameters>]

Paramètres

Paramètre Description
ID (Obligatoire) Identifiant du package à synchroniser. Le commutateur -Id proprement dit est facultatif.
IgnoreDependencies Installez uniquement ce package, et non ses dépendances.
Nom du projet Projet à partir duquel synchroniser le package, par défaut le projet par défaut.
Version Version du package à synchroniser, par défaut la version actuellement installée.
Source URL ou chemin d’accès au dossier de la source du package à rechercher. Les chemins d’accès aux dossiers locaux peuvent être absolus ou relatifs au dossier actif. En cas d’omission, Sync-Package recherche la source du package actuellement sélectionné.
IncludePrerelease Inclut des packages de préversion dans la synchronisation.
FileConflictAction Action à entreprendre lorsqu’il est demandé de remplacer ou d’ignorer les fichiers existants référencés par le projet. Les valeurs possibles sont Overwrite (remplacer), Ignore (ignorer), None (néant), OverwriteAll (remplacer tout) et (3.0+)IgnoreAll (ignorer tout).
DependencyVersion Version des packages de dépendances à utiliser, qui peut être l’une des suivantes :
  • Lowest (valeur par défaut) : la version la plus basse
  • HighestPatch : la version avec la majeure la plus basse, la mineure la plus basse et le correctif le plus élevé
  • HighestMinor : la version avec la majeure la plus basse, la mineure la plus élevée et le correctif le plus élevé
  • Highest (valeur par défaut d’Update-Package sans paramètres) : la version la plus élevée
Vous pouvez définir la valeur par défaut à l’aide du réglage dependencyVersion dans le fichier Nuget.Config.
WhatIf Affiche ce qui se passerait lors de l’exécution de la commande sans effectuer la synchronisation.

Aucun de ces paramètres n’accepte d’entrée de pipeline ou de caractères génériques.

Paramètres communs

Sync-Package prend en charge les paramètres courants suivants : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable.

Exemples

# Sync the Elmah package installed in the default project into the other projects in the solution
Sync-Package Elmah

# Sync the Elmah package installed in the ClassLibrary1 project into other projects in the solution
Sync-Package Elmah -ProjectName ClassLibrary1

# Sync Microsoft.Aspnet.package but not its dependencies into the other projects in the solution
Sync-Package Microsoft.Aspnet.Mvc -IgnoreDependencies

# Sync jQuery.Validation and install the highest version of jQuery (a dependency) from the package source    
Sync-Package jQuery.Validation -DependencyVersion highest