dotnet paket güncelleştirmesi

Bu makale şunlar için geçerlidir: .NET 10 SDK ve sonraki sürümleri ✔️

İsim

dotnet package update - Bir projede başvuruda bulunan paketleri güncelleştirme.

Özet

dotnet package update [<packages>...]
    [--interactive] [--project <path>]
    [--verbosity <level>] [--vulnerable]

dotnet package update -h|--help

Description

dotnet package update komutu projeler tarafından kullanılan paketleri güncelleştirir. NuGetAudit etkinleştirildiyse, bilinen güvenlik açıklarıyla güncelleştirme paketlerini sabit sürümlere otomatik olarak güncelleştirmeyi de dener.

Hata Olarak Uyarılar

dotnet package update , sonuçta elde edilen paket grafiğinde hata olup olmadığını denetlemek için örtük geri yükleme yapar. kullanarak --vulnerable nuGetAudit uyarılarını bulmak için örtük bir geri yükleme de yapar. Ancak, projeniz veya WarningsAsErrorskullanıyorsa TreatWarningsAsErrors NuGet'in geri yükleme uyarıları geri yüklemenin başarısız olmasına neden olabilir ve güncelleştirmenin tamamlanmasını engelleyebilir.

Bu özellik isteği uygulanana kadar geçici bir çözüm olarak MSBuild koşullarından ve ortam değişkenlerinden yararlanmanızı öneririz. Örneğin, projenizde ayarlayın <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> ve ardından çoğu Linux ve Mac kabuğunda komutunu çalıştırabilirsiniz CustomCondition=true dotnet package update. Windows Komut İstemi ve PowerShell'de ortam değişkenini ayarlamanız, dotnet paket güncelleştirmesini çalıştırmanız ve ardından ortam değişkenini üç ayrı komut olarak ayarlamanız gerekir.

Arguments

• packages

  Güncelleştirilecek paketlerin isteğe bağlı bir listesi. Hiçbir paket sağlanmayan komut, proje tarafından başvuruda bulunan tüm paketleri güncelleştirmeye çalışır. Paketler isteğe bağlı olarak @ bir paket adı ve bir sürüm numarası olabilir. Örneğin, dotnet package update Contoso.Utilities veya dotnet package update Contoso.Utilities@3.2.1. Sürüm sağlanmazsa, yapılandırılan paket kaynaklarında kullanılabilen en yüksek sürümü bulur.

Options

• --interactive

  Komutun durmasına ve kullanıcı girişini veya eylemini beklemesine izin verir. Örneğin, kimlik doğrulamasını tamamlamak için.

• --project <path>

  Paketlerin güncelleştirilmesi gereken proje. Bir dizin sağlanırsa, dizindeki proje ve çözüm dosyalarını arar. Varsayılan olarak geçerli çalışma dizinine geçer.

• -v|--verbosity <LEVEL>

  Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , q[uiet], m[inimal], n[ormal]ve d[etailed]diag[nostic]. Daha fazla bilgi için bkz. LoggerVerbosity.

• --vulnerable

  Geri yükleme, bilinen güvenlik açıklarına sahip olan paketleri bildirirse, bu komut bu paketleri yükseltecektir. Bu seçeneğin kullanılması, paketleri şu anda başvurulmakta olan ve bilinen güvenlik açıklarına sahip olmayan en düşük sürüme yükseltecektir.

• -?|-h|--help

  komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

Örnekler

• Projedeki tüm paketleri kullanılabilir en yüksek sürüme güncelleştirin

  dotnet package update
  

  Updating outdated packages in S:\src\test\update\ConsoleApp1.
    ConsoleApp1:
      Updated Microsoft.Extensions.Configuration 9.0.0 to 9.0.9.
      Updated Microsoft.Extensions.DependencyInjection 9.0.0 to 9.0.9.
  
  Updated 2 packages in 7 scanned packages.
  

• Contoso.Utilities'i kullanılabilir en yüksek sürüme ve Fabrikam.WebApi'yi 1.2.3 sürümüne güncelleştirin

  dotnet package update Contoso.Utilities Fabrikam.WebApi@1.2.3
  

  Updating outdated packages in S:\src\test\update\ConsoleApp1.
    ConsoleApp1:
      Updated Contoso.Utilities 2.3.1 to 2.4.6.
      Updated Fabrikam.WebApi 1.0.2 to 1.2.3.
  
  Updated 2 packages in 2 scanned packages.
  

• Paketleri bilinen güvenlik açıklarıyla güncelleştirme

  dotnet package update --vulnerable
  

  Updating packages with security advisories in S:\src\test\update\ConsoleApp1
    ConsoleApp1:
      Updating System.Text.Json 8.0.0 to 8.0.5.
  
  Updated 1 packages in 31 scanned packages.