Sync-Package (Console do Gerenciador de Pacotes no Visual Studio)

  • Artigo

Versão 3.0+, disponível somente no Console do Gerenciador de Pacotes NuGet no Visual Studio no Windows.

Obtém a versão do pacote instalado do projeto especificado (ou padrão) e sincroniza a versão com o restante dos projetos na solução.

Sintaxe

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

Parâmetros

Parâmetro Descrição
ID (Obrigatório) O identificador do pacote a ser sincronizado. A opção -Id em si é opcional.
IgnoreDependencies Instale somente esse pacote e não suas dependências.
ProjectName O projeto do qual sincronizar o pacote, padrão para o projeto padrão.
Versão A versão do pacote a ser sincronizado, assumindo o padrão da última versão.
Origem A URL ou o caminho da pasta para a origem do pacote a ser pesquisada. Os caminhos da pasta local podem ser absolutos ou relativos à pasta atual. Se omitido, Sync-Package pesquisa a origem do pacote selecionado no momento.
IncludePrerelease Inclui pacotes de pré-lançamento na sincronização.
FileConflictAction A ação a ser executada quando solicitado a substituir ou ignorar arquivos existentes referenciados pelo projeto. Os valores possíveis são Overwrite, Ignore, None, OverwriteAll e (3.0+)IgnoreAll.
DependencyVersion A versão dos pacotes de dependência a serem usados, que pode ser uma das seguintes:
  • Lowest (padrão): a versão mais baixa
  • HighestPatch: a versão com o patch mais baixo maior, mais baixo maior, mais alto
  • HighestMinor: a versão com o patch mais baixo maior, mais alto menor, mais alto
  • Highest (padrão para Update-Package sem parâmetros): a versão mais alta
É possível definir o valor padrão usando a configuração dependencyVersion no arquivo Nuget.Config.
WhatIf Mostra o que aconteceria ao executar o comando sem realmente executar a sincronização.

Nenhum desses parâmetros aceita entrada de pipeline ou caracteres curinga.

Parâmetros comuns

O Sync-Package oferece suporte aos seguintes parâmetros comuns do PowerShell: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction e WarningVariable.

Exemplos

# 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