Share via


Güncelleştirme Paketi (Visual Studio'da Paket Yöneticisi Konsolu)

Yalnızca Windows üzerinde Visual Studio'daki NuGet Paket Yöneticisi Konsolu'nda kullanılabilir.

Bir paketi ve bağımlılıklarını veya projedeki tüm paketleri daha yeni bir sürüme Güncelleştirmeler.

Sözdizimi

Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
    [-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
    [-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]

NuGet 2.8+'da, Update-Package projenizdeki mevcut bir paketi düşürmek için kullanılabilir. Örneğin, Microsoft.AspNet.MVC 5.1.0-rc1 yüklüyse, aşağıdaki komut bunu 5.0.0'a düşürecek:

Update-Package Microsoft.AspNet.MVC -Version 5.0.0.

Parametreler

Parametre Açıklama
Kimlik Güncelleştirilecek paketin tanımlayıcısı. Atlanırsa, tüm paketleri güncelleştirir. -Id anahtarının kendisi isteğe bağlıdır.
IgnoreDependencies Paketin bağımlılıklarını güncelleştirme işlemini atlar.
ProjectName Güncelleştirilecek paketleri içeren projenin adı ve varsayılan olarak tüm projeler.
Sürüm Yükseltme için kullanılacak sürüm, varsayılan olarak en son sürümdür. NuGet 3.0+ sürümünde sürüm değeri En Düşük, En Yüksek, En Yüksek, En YüksekMinor veya HighestPatch 'den biri olmalıdır (-Kasa eşdeğeri).
Safe Yükseltmeleri yalnızca şu anda yüklü olan paketle aynı Birincil ve İkincil sürüme sahip sürümlere kısıtlar.
Source Aranacak paket kaynağının URL'si veya klasör yolu. Yerel klasör yolları mutlak veya geçerli klasöre göre olabilir. Atlanırsa, Update-Package seçili durumdaki paket kaynağını arar.
IncludePrerelease Güncelleştirmeler için yayın öncesi paketleri içerir.
Yeni -den yüklemek Paketleri şu anda yüklü olan sürümlerini kullanarak yeniden yükler. Bkz . Paketleri yeniden yükleme ve güncelleştirme.
FileConflictAction Proje tarafından başvuruda bulunan mevcut dosyaların üzerine yazılmasını veya yoksayılmasını istendiğinde gerçekleştirecek eylem. Olası değerler Overwrite, Ignore, None, OverwriteAll ve IgnoreAll (3.0+) değerleridir.
DependencyVersion Kullanılacak bağımlılık paketlerinin sürümü, aşağıdakilerden biri olabilir:
  • En düşük (varsayılan): en düşük sürüm
  • HighestPatch: En düşük ana, en düşük ikincil, en yüksek düzeltme ekini içeren sürüm
  • HighestMinor: En düşük ana, en yüksek küçük, en yüksek düzeltme ekini içeren sürüm
  • En yüksek (parametre içermeyen Update-Package için varsayılan): en yüksek sürüm
Dosyadaki ayarı Nuget.Config kullanarak dependencyVersion varsayılan değeri ayarlayabilirsiniz.
ToHighestPatch -Kasa eşdeğerdir.
ToHighestMinor Yükseltmeleri yalnızca şu anda yüklü olan paketle aynı Ana sürüme sahip sürümlere kısıtlar.
WhatIf Güncelleştirmeyi gerçekleştirmeden komutu çalıştırırken ne olacağını gösterir.

Bu parametrelerden hiçbiri işlem hattı girişini veya joker karakterlerini kabul etmemektedir.

Ortak Parametreler

Update-Package şu yaygın PowerShell parametrelerini destekler: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction ve WarningVariable.

Örnekler

# Updates all packages in every project of the solution
Update-Package

# Updates every package in the MvcApplication1 project
Update-Package -ProjectName MvcApplication1

# Updates the Elmah package in every project to the latest version
Update-Package Elmah

# Updates the Elmah package to version 1.1.0 in every project showing optional -Id usage
Update-Package -Id Elmah -Version 1.1.0

# Updates the Elmah package within the MvcApplication1 project to the highest "safe" version.
# For example, if Elmah version 1.0.0 of a package is installed, and versions 1.0.1, 1.0.2,
# and 1.1 are available in the feed, the -Safe parameter updates the package to 1.0.2 instead
# of 1.1 as it would otherwise.
Update-Package Elmah -ProjectName MvcApplication1 -Safe

# Reinstall the same version of the original package, but with the latest version of dependencies
# (subject to version constraints). If this command rolls a dependency back to an earlier version,
# use Update-Package <dependency_name> to reinstall that one dependency without affecting the
# dependent package.
Update-Package Elmah –reinstall 

# Reinstall the Elmah package in just MyProject
Update-Package Elmah -ProjectName MyProject -reinstall

# Reinstall the same version of the original package without touching dependencies.
Update-Package Elmah –reinstall -ignoreDependencies