Megosztás:

dotnet tool exec

Ez a cikk a következőre vonatkozik: ✔️ .NET 10.0.100 SDK és újabb verziók

Név

dotnet tool exec – Letölt és meghív egy .NET-eszközt anélkül, hogy véglegesen telepíti.

Áttekintés

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

A dotnet tool exec parancs egy lövéses eszközhívási módot biztosít a .NET-eszközökhöz. Automatikusan letölti a megadott eszközcsomagot a NuGet-gyorsítótárba, és meghívja azt a rendszer PATH módosítása vagy állandó telepítés megkövetelése nélkül.

Futtatáskor dotnet tool execa parancs:

  1. Ellenőrzi a megadott verziót (vagy verziótartományt) (vagy ha nincs megadva a legújabb verzió) a konfigurált NuGet-hírcsatornákon, hogy eldöntse, melyik csomagot töltse le.
  2. Letölti a megadott csomagot a NuGet-gyorsítótárba (ha még nincs jelen).
  3. Meghívja az eszközt a megadott argumentumokkal.
  4. Az eszköz kilépési kódját adja vissza.

dotnet tool exec a globális és a helyi eszközökkel is zökkenőmentesen működik. Ha rendelkezésre áll egy helyi eszközjegyzék, az a jegyzék használatával határozza meg az eszköz futtatandó verzióját.

Ez a parancs két másik űrlapon is létezik a könnyebb használat érdekében

  • dotnet dnx - Rejtett alias dotnet tool exec , amely a szkript egyszerű implementálására dnx szolgál
  • dnx - Az SDK-ból meghívott rendszerhéjszkript dotnet dnx . Ezt a szkriptet a telepítő biztosítja, és a következő webhelyen PATHérhető el: . Lehetővé teszi az eszközök nagyon egyszerű használatát közvetlenül a dnx <toolname>.

Arguments

  • PACKAGE_NAME

    A végrehajtandó .NET-eszköz NuGet-csomagazonosítója. Megadhat például egy verziót a @ szintaxis dotnetsay@2.1.0használatával.

  • tool-arguments

    A végrehajtás alatt álló eszköznek továbbítandó argumentumok. Minden, ami után -- közvetlenül az eszközre kerül.

Beállítások

  • --allow-roll-forward

    Engedélyezze az eszköznek, hogy a .NET-futtatókörnyezet újabb verzióját használja, ha a célként megadott futtatókörnyezet nincs telepítve.

  • --add-source <SOURCE>

    Hozzáad egy további NuGet-csomagforrást, amelyet a telepítés során használhat. A hírcsatornák párhuzamosan érhetők el, nem tartalék kaszkádolt sorrendben. Ha ugyanaz a csomag és verzió több hírcsatornában is elérhető, a leggyorsabb hírcsatorna nyer. További információ: Mi történik a NuGet-csomag telepítésekor? Ezt a NuGet-csomag forrásleképezésével szabályozhatja. További információ: Csomagforrás-leképezés.

  • --configfile <FILE>

    A használni kívánt NuGet-konfigurációs fájl (nuget.config). Ha meg van adva, a rendszer csak a fájlból származó beállításokat használja. Ha nincs megadva, a rendszer az aktuális könyvtárból származó konfigurációs fájlok hierarchiáját használja. További információ: Common NuGet Configurations.

  • --disable-parallel

    Megakadályozza több projekt párhuzamos visszaállítását.

  • --ignore-failed-sources

    Figyelmeztetésként kezeli a csomag forráshibáit.

  • --interactive

    Lehetővé teszi, hogy a parancs leálljon, és várja meg a felhasználói bemenetet vagy műveletet. Például a hitelesítés befejezéséhez.

  • --no-http-cache

    Nem gyorsítótárazza a HTTP-kéréseket a konfigurált NuGet-hírcsatornákhoz.

  • --prerelease

    Lehetővé teszi az előzetes csomagok kiválasztását a verzió telepítésekor.

  • --source <SOURCE>

    Megadja a NuGet-csomagok forrását.

  • -v|--verbosity <LEVEL>

    A parancs részletességi szintjét állítja be. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. Az alapértelmezett érték a normal. További információért lásd LoggerVerbosity.

  • -?|-h|--help

    A parancs használatának leírását nyomtatja ki.

Példák

  • dotnet tool exec dotnetsay

    Letölti (ha szükséges), és az eszköz legújabb verzióját futtatja dotnetsay .

  • dotnet tool exec dotnetsay@2.1.0

    Letölti (ha szükséges) és futtatja az dotnetsay eszköz 2.1.0-s verzióját.

  • dotnet tool exec dotnetsay@2.*

    Letölti (ha szükséges) és futtatja az dotnetsay eszköz legújabb verzióját a 2.x verziótartományban.

  • dotnet tool exec dotnetsay -- Hello World

    Futtatja az dotnetsay eszközt, és argumentumként átadja a "Hello World" kifejezést az eszköznek.

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

    Letölti és futtatja mytool a megadott NuGet-forrást.

Összehasonlítás más parancsokkal

Ez a parancs egységes módot szolgál a .NET-eszközök használatához. Bár a korábban elérhető eszköztelepítési parancsok továbbra is elérhetők maradnak, dotnet tool exec a legtöbb felhasználó számára egyszerűbb és rugalmasabb felületet biztosít.

Command Cél Installation Scope
dotnet tool exec Egylövetű végrehajtás Nincs (csak gyorsítótárazott) Temporary
dotnet tool install -g Állandó globális telepítés Global Rendszerszintű
dotnet tool install Állandó helyi telepítés Helyi jegyzék Projekt
dotnet tool run Már telepített helyi eszköz futtatása Előzetes telepítést igényel Projekt

A dotnet tool install -g parancs továbbra is fontos célt szolgál azon felhasználók számára, akik végleg telepíteni szeretnének egy eszközt. Azok a felhasználók azonban, akik ki szeretnének próbálni egy eszközt, vagy ci/CD-folyamaton szeretnék futtatni, dotnet tool exec gyakran jobb választás.

Lásd még

  • Last updated on