Sync-Package (Paket-Manager-Konsole in Visual Studio)

  • Artikel

Version 3.0+; Nur in der Paket-Manager-Konsole in Visual Studio unter Windows verfügbar.

Ruft die Version des installierten Pakets aus dem angegebenen (oder Standard-) Projekt ab und synchronisiert die Version mit den übrigen Projekten im Projektordner.

Syntax

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

Parameter

Parameter Beschreibung
Id (Erforderlich) Der Bezeichner des zu synchronisierenden Pakets. Die Switch-ID selbst ist optional.
Abhängigkeiten ignorieren (IgnoreDependencies) Installieren Sie nur das Paket ohne seine Abhängigkeiten.
Projektname Das Projekt, von dem aus das Paket synchronisiert werden soll, wird automatisch als Standardprojekt angesehen.
Version Die Version des zu synchronisierenden Pakets, standardmäßig die aktuell installierte Version
Quelle Die URL oder der Ordnerpfad für die zu durchsuchende Paketquelle. Lokale Ordnerpfade können absolut oder relativ zum aktuellen Ordner sein. Wenn sie weggelassen werden, durchsucht Sync-Package die aktuell ausgewählte Paketquelle.
Vorabversion einbeziehen (IncludePrerelease) Zieht Vorabversionen von Paketen in der Synchronisierung mit ein.
Dateikonflikt-Aktion (FileConflictAction) Die Aktion, die ausgeführt werden soll, wenn Sie aufgefordert werden, vorhandene Dateien, auf die das Projekt verweist, zu überschreiben oder zu ignorieren. Mögliche Werte sind: Overwrite, Ignore, None, OverwriteAll und (3,0+)IgnoreAll.
Abhängigkeitsversion (DependencyVersion) Die Version der zu verwendenden Abhängigkeitspakete, die eine der folgenden sein kann:
  • Niedrigste (Standard): die niedrigste Version
  • HighestPatch: die Version mit dem niedrigsten Maximum, dem niedrigsten Minimum und dem höchsten Patch
  • HighestMinor: die Version mit dem niedrigsten Maximum, dem höchsten Minimum und dem höchsten Patch
  • Highest (Standardwert für das Update-Paket ohne Parameter): die höchste Version
Sie können den Standardwert über die dependencyVersion-Einstellung in der Nuget.Config-Datei festlegen.
WhatIf Zeigt, was passieren würde, wenn Sie den Befehl ausführen, ohne die Synchronisierung tatsächlich durchzuführen.

Keiner dieser Parameter akzeptiert Pipeline-Eingaben oder Platzhalterzeichen.

Allgemeine Parameter

Sync-Package unterstützt die folgenden gängigen PowerShell-Parameter: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction und WarningVariable.

Beispiele

# 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