Aracılığıyla paylaş

dotnet tool exec

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

İsim

dotnet tool exec - Kalıcı olarak yüklemeden bir .NET aracını indirir ve çağırır.

Özet

dotnet tool exec <PACKAGE_NAME>[@<VERSION>]
    [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-http-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Description

dotnet tool exec komutu.NET Araçları için tek seferlik bir araç çağırma modu sağlar. Belirtilen araç paketini otomatik olarak NuGet önbelleğine indirir ve sisteminizi PATH değiştirmeden veya kalıcı yükleme gerektirmeden çağırır.

komutunu çalıştırdığınızda dotnet tool execşu komutu kullanın:

  1. Hangi paketi indireceğinize karar vermek için, belirttiğiniz sürümü (veya sürüm aralığını) (veya belirtilmemişse en son sürümü) yapılandırdığınız NuGet akışlarına göre denetler.
  2. Belirtilen paketi NuGet önbelleğine indirir (yoksa).
  3. Sağlanan bağımsız değişkenlerle aracı çağırır.
  4. Aracın çıkış kodunu döndürür.

dotnet tool exec hem genel hem de yerel araçlarla sorunsuz bir şekilde çalışır. Kullanılabilir bir yerel araç bildiriminiz varsa, aracın hangi sürümünün çalıştırılacak olduğunu belirlemek için bildirimini kullanır.

Bu komut daha kolay kullanım için diğer iki biçimde de mevcuttur

  • dotnet dnx- Betiğin kendisini kolayca uygulamanın dotnet tool exec bir yolu olarak kullanılan gizli diğer ad dnx
  • dnx - SDK'dan çağrılan dotnet dnx bir kabuk betiği. Bu betik yükleyici tarafından sağlanır ve üzerinde PATHkullanılabilir. Araçları doğrudan aracılığıyla dnx <toolname>çok basit bir şekilde kullanımına olanak tanır.

Arguments

  • PACKAGE_NAME

    Yürütülecek .NET aracının NuGet paket kimliği. İsteğe bağlı olarak söz dizimini @ kullanarak bir sürüm belirtebilirsiniz, örneğin dotnetsay@2.1.0.

  • tool-arguments

    Yürütülmekte olan ara çubuğuna geçirilmeye yönelik bağımsız değişkenler. Sonrasındaki -- her şey doğrudan ara çubuğuna geçirilir.

Options

  • --allow-roll-forward

    Hedeflediğinden çalışma zamanı yüklü değilse aracın .NET çalışma zamanının daha yeni bir sürümünü kullanmasına izin verin.

  • --add-source <SOURCE>

    Yükleme sırasında kullanılacak ek bir NuGet paket kaynağı ekler. Akışlara paralel olarak erişilir, geri dönüş art arda sıralı olarak erişilmez. Aynı paket ve sürüm birden çok akışta kullanılabiliyorsa, en hızlı akış kazanır. Daha fazla bilgi için bkz. NuGet paketi yüklendiğinde ne olur? NuGet paket kaynağı eşlemesi kullanarak bunu denetleyebilirsiniz. Daha fazla bilgi için bkz. Paket Kaynağı Eşlemesi.

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

  • --ignore-failed-sources

    Paket kaynağı hatalarını uyarı olarak ele alır.

  • --interactive

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

  • --no-http-cache

    HTTP isteklerini yapılandırılan NuGet akışlarına önbelleğe almaz.

  • --prerelease

    Yüklenecek sürüm çözümlenirken ön sürüm paketlerinin seçilmesine izin verir.

  • --source <SOURCE>

    NuGet paketlerinin kaynağını belirtir.

  • -v|--verbosity <LEVEL>

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

  • -?|-h|--help

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

Örnekler

  • dotnet tool exec dotnetsay

    Aracın en son sürümünü dotnetsay indirir (gerekirse) ve çalıştırır.

  • dotnet tool exec dotnetsay@2.1.0

    Aracın 2.1.0 dotnetsay sürümünü indirir (gerekirse) ve çalıştırır.

  • dotnet tool exec dotnetsay@2.*

    Aracın en son sürümünü dotnetsay indirir (gerekirse) ve 2.x sürüm aralığında çalıştırır.

  • dotnet tool exec dotnetsay -- Hello World

    dotnetsay Aracı çalıştırır ve "Hello World" öğesini ara çubuğuna bağımsız değişken olarak geçirir.

  • dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool

    Belirtilen NuGet kaynağını kullanarak indirir ve çalıştırır mytool .

Diğer komutlarla karşılaştırma

Bu komut, .NET Araçları ile çalışmanın birleşik bir yolu olarak tasarlanmıştır. Önceden kullanılabilir araç yükleme komutları kullanılabilir durumda olsa da, dotnet tool exec çoğu kullanıcı için daha basit ve daha esnek bir deneyim sağlar.

Command Amaç Kurulum Scope
dotnet tool exec Tek seferlik yürütme Yok (yalnızca önbelleğe alınmış) Temporary
dotnet tool install -g Kalıcı genel yükleme Global Sistem genelinde
dotnet tool install Kalıcı yerel yükleme Yerel bildirim Project
dotnet tool run Önceden yüklenmiş bir yerel aracı çalıştırma Önceden yükleme gerektirir Project

Komut dotnet tool install -g , kalıcı olarak bir araç yüklemek isteyen kullanıcılar için önemli bir amaca hizmet eder. Ancak, bir aracı denemek veya CI/CD işlem hattında dotnet tool exec çalıştırmak isteyen kullanıcılar için genellikle daha uygundur.

Ayrıca bakınız

  • Last updated on