Прочитать на английском

Поделиться через

Sync-Package (консоль диспетчер пакетов в Visual Studio)

  • Статья
  • 17.07.2024

Версия 3.0+; доступно только в консоли диспетчер пакетов в Visual Studio в Windows.

Возвращает версию установленного пакета из указанного проекта (или по умолчанию) и синхронизирует версию с остальными проектами в решении.

Синтаксис

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

Параметры

Параметр Описание
Артикул (обязательно) Идентификатор пакета для синхронизации. Сам параметр -Id является необязательным.
IgnoreDependencies Установите только этот пакет, а не его зависимости.
Имя проекта Проект для синхронизации пакета по умолчанию с проектом по умолчанию.
Версия Версия пакета для синхронизации по умолчанию с установленной версией.
Исходный код Путь к URL-адресу или папке для поиска источника пакета. Путь к локальной папке может быть абсолютным или относительным к текущей папке. Если опущено, Sync-Package выполняется поиск выбранного в данный момент источника пакета.
IncludePrerelease Включает пакеты предварительного выпуска в синхронизацию.
FileConflictAction Действие, выполняемого при запросе перезаписать или игнорировать существующие файлы, на которые ссылается проект. Возможные значения: Overwrite, Ignore, None, OverwriteAll и (3.0+) IgnoreAll.
DependencyVersion Версия используемых пакетов зависимостей, которая может быть одной из следующих:
  • Самый низкий (по умолчанию): самая низкая версия
  • HighestPatch: версия с наименьшим основным, наименьшим дополнительным, самым высоким исправлением
  • Самый высокий Минор: версия с самым низким основным, самым высоким дополнительным, самым высоким исправлением
  • Самый высокий (по умолчанию для update-Package без параметров): самая высокая версия
Значение по умолчанию можно задать с помощью dependencyVersion параметра в Nuget.Config файле.
WhatIf Показывает, что произойдет при выполнении команды, не выполняя синхронизацию.

Ни один из этих параметров не принимает входные или подстановочные знаки конвейера.

Общие параметры

Sync-Package поддерживает следующие распространенные параметры PowerShell: отладка, действие ошибки, errorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction и WarningVariable.

Примеры

# 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