Aracılığıyla paylaş


"dotnet tool update" komutunu güncelleştir

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

İsim

dotnet tool update - Makinenizde belirtilen .NET aracını güncelleştirir.

Özet

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] 
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

Açıklama

komutu, dotnet tool update makinenizdeki .NET araçlarını paketin en son kararlı sürümüne güncelleştirmeniz için bir yol sağlar. Komutu bir aracı kaldırır ve yeniden yükler ve etkili bir şekilde güncelleştirir. komutunu kullanmak için aşağıdaki seçeneklerden birini belirtin:

  • Varsayılan konuma --global yüklenmiş bir genel aracı güncelleştirmek için
  • Özel bir konuma yüklenmiş genel bir aracı güncelleştirmek için seçeneğini kullanın --tool-path .
  • Yerel bir aracı güncelleştirmek için seçeneğini kullanın --local .

Tartışmalar

  • PACKAGE_ID

    Güncelleştirilecek .NET genel aracını içeren NuGet paketinin adı/kimliği.

    .NET 10.0.100 SDK'dan başlayarak, .NET aracını güncelleştirmek için ad/kimlik ve ile @ ayrılmış sürümü kullanın.

    Paket adını dotnet tool list komutunu kullanarak bulabilirsiniz.

Seçenekler

  • --add-source <SOURCE>

    Yükleme sırasında kullanılacak ek bir NuGet paket kaynağı ekler. Akışlara belirli bir öncelik sırasına göre sıralı olarak değil paralel olarak erişilir. Aynı paket ve sürüm birden çok akıştaysa, en hızlı akış kazanır. Daha fazla bilgi için bkz . NuGet paketi yüklendiğinde ne olur?.

  • --all

    Tüm araçları güncelleştirin.

  • --allow-downgrade

    .NET araç paketini yüklerken veya güncelleştirirken paketin sürüm düşürmesine izin verin. "İstenen x.x.x sürümü var olan x.x.x sürümünden daha düşük" uyarısını gizler.

  • --configfile <FILE>

    Kullanılacak NuGet yapılandırma dosyası (nuget.config). Belirtilirse, yalnızca bu dosyadaki ayarlar kullanılır. Belirtilmezse, geçerli dizindeki yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz . Yaygın NuGet Yapılandırmaları.

  • --disable-parallel

    Birden çok projenin paralel olarak geri yüklenmesini engeller.

  • --framework <FRAMEWORK>

    Aracını güncelleştirmek için hedef çerçeveyi belirtir.

  • -g|--global

    Güncelleştirmenin kullanıcı genelindeki bir araç için olduğunu belirtir. Seçeneğiyle --tool-path birleştirilemiyor. Hem atlanır hem --global de --tool-path güncelleştirilecek aracın yerel bir araç olduğunu belirtir.

  • -?|-h|--help

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

  • --ignore-failed-sources

    Paket kaynağı hatalarını uyarı olarak değerlendirin.

  • --interactive

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

  • --local

    Aracı ve yerel araç bildirimini güncelleştirin. Seçenek veya --global seçenek ile --tool-path birleştirilemiyor.

  • --no-cache

    Paketleri ve HTTP isteklerini önbelleğe alma.

  • --prerelease

    Yayın öncesi sürümleri dahil edin.

  • --source <SOURCE>

    NuGet paketlerinin kaynağını belirtir.

  • --tool-manifest <PATH>

    Bildirim dosyasının yolu.

  • --tool-path <PATH>

    Genel aracın yüklendiği konumu belirtir. PATH mutlak veya göreli olabilir. Seçeneğiyle --global birleştirilemiyor. Hem atlanır hem --global de --tool-path güncelleştirilecek aracın yerel bir araç olduğunu belirtir.

  • -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.

  • --version <VERSION>

    Güncelleştirilecek araç paketinin sürüm aralığı. Bu, sürümleri düşürmek için kullanılamaz, önce daha yeni sürümleri kullanmanız gerekir uninstall .

    .NET 8.0 sürümünden başlayarak, --version Major.Minor.Patch listelenmemiş sürümler de dahil olmak üzere belirli bir major.minor.patch sürümünü ifade eder. Bunun yerine belirli bir major.minor sürümünün en son sürümünü almak için kullanın --version Major.Minor.*.

Örnekler

  • dotnet tool update -g dotnetsay

    dotnetsay genel aracını güncelleştirir.

  • dotnet tool update dotnetsay --tool-path c:\global-tools

    Belirli bir Windows dizininde bulunan dotnetsay genel aracını güncelleştirir.

  • dotnet tool update dotnetsay --tool-path ~/bin

    Belirli bir Linux/macOS dizininde bulunan dotnetsay genel aracını güncelleştirir.

  • dotnet tool update dotnetsay

    Geçerli dizin için yüklenen dotnetsay yerel aracını güncelleştirir.

  • dotnet tool update -g dotnetsay --version 2.0.*

    dotnetsay genel aracını, ana sürümü 2ve ikincil sürümüyle en son düzeltme eki sürümüne 0güncelleştirir.

  • dotnet tool update -g dotnetsay@2.1.7*

    dotnetsay genel aracını en son düzeltme eki sürümü olan 2.1.7'ye güncelleştirir.

  • dotnet tool update -g dotnetsay --version (2.0.0,2.1.7)

    dotnetsay genel aracını belirtilen aralıktaki (> 2.0.0 && < 2.1.7)en düşük sürüme güncelleştirir. Sürüm 2.1.0 yüklenir. Anlamsal sürüm oluşturma aralıkları hakkında daha fazla bilgi için bkz. NuGet paketleme sürüm aralıkları.

Ayrıca bakınız