Sdílet prostřednictvím

dotnet tool exec (příkaz pro spuštění nástroje v prostředí .NET)

Tento článek se vztahuje na: ✔️ .NET 10.0.100 SDK a novější verze

Název

dotnet tool exec - Stáhne a vyvolá nástroj .NET bez trvalé instalace.

Přehled

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

Příkaz dotnet tool exec poskytuje režim vyvolání jednoho nástroje pro nástroje .NET. Automaticky stáhne zadaný balíček nástrojů do mezipaměti NuGet a vyvolá ho beze změny systému PATH nebo vyžadování trvalé instalace.

Při spuštění dotnet tool execpříkazu:

  1. Zkontroluje, jakou verzi (nebo rozsah verzí) zadáte (nebo nejnovější verzi, pokud není zadána žádná) v nakonfigurovaných informačních kanálech NuGet a rozhodnete se, který balíček se má stáhnout.
  2. Stáhne zadaný balíček do mezipaměti NuGet (pokud ještě není k dispozici).
  3. Vyvolá nástroj s libovolnými zadanými argumenty.
  4. Vrátí ukončovací kód nástroje.

dotnet tool exec funguje bezproblémově s globálními i místními nástroji. Pokud máte k dispozici místní manifest nástroje, použije manifest k určení verze nástroje, která se má spustit.

Tento příkaz existuje také ve dvou dalších formulářích pro snadnější použití.

  • dotnet dnx – Skrytý alias, dotnet tool exec který se používá jako způsob snadné implementace samotného dnx skriptu
  • dnx – Skript prostředí, který se vyvolá dotnet dnx ze sady SDK. Tento skript poskytuje instalační program a je k dispozici na serveru PATH. Umožňuje velmi jednoduché použití nástrojů přímo prostřednictvím dnx <toolname>.

Arguments

  • PACKAGE_NAME

    ID balíčku NuGet nástroje .NET ke spuštění. Volitelně můžete zadat verzi pomocí @ syntaxe, například dotnetsay@2.1.0.

  • tool-arguments

    Argumenty, které se mají předat nástroji, který se provádí. Všechno po -- předání přímo nástroji.

Možnosti

  • --allow-roll-forward

    Pokud modul runtime .NET není nainstalovaný, povolte nástroj použití novější verze modulu runtime .NET.

  • --add-source <SOURCE>

    Přidá další zdroj balíčku NuGet, který se použije během instalace. Informační kanály jsou přístupné paralelně, ne v záložní kaskádové sekvenci. Pokud je stejný balíček a verze k dispozici ve více informačních kanálech, nejrychlejší kanál vyhraje. Další informace najdete v tématu Co se stane při instalaci balíčku NuGet. Můžete to řídit pomocí mapování zdroje balíčku NuGet. Další informace naleznete v tématu Mapování zdrojů balíčků.

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu Běžné konfigurace NuGet.

  • --disable-parallel

    Zabraňuje paralelnímu obnovení více projektů.

  • --ignore-failed-sources

    Zpracovává selhání zdroje balíčků jako upozornění.

  • --interactive

    Umožňuje příkazu zastavit a čekat na uživatelský vstup nebo akci. Například k dokončení ověřování.

  • --no-http-cache

    Neuvádí požadavky HTTP do mezipaměti do nakonfigurovaných informačních kanálů NuGet.

  • --prerelease

    Umožňuje vybrat předběžné verze balíčků při překladu verze, která se má nainstalovat.

  • --source <SOURCE>

    Určuje zdroj balíčků NuGet.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je normal. Další informace najdete v tématu LoggerVerbosity.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

Examples

  • dotnet tool exec dotnetsay

    Stáhne (v případě potřeby) a spustí nejnovější verzi dotnetsay nástroje.

  • dotnet tool exec dotnetsay@2.1.0

    Stáhne se (v případě potřeby) a spustí se verze dotnetsay 2.1.0 nástroje.

  • dotnet tool exec dotnetsay@2.*

    Stáhne (v případě potřeby) a spustí nejnovější verzi dotnetsay nástroje v rozsahu verzí 2.x.

  • dotnet tool exec dotnetsay -- Hello World

    dotnetsay Spustí nástroj a předá nástroj Hello World jako argumenty nástroji.

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

    Stáhne a spustí mytool se pomocí zadaného zdroje NuGet.

Porovnání s jinými příkazy

Tento příkaz má být jednotným způsobem práce s nástroji .NET Tools. I když dříve dostupné příkazy pro instalaci nástrojů zůstávají dostupné, dotnet tool exec poskytuje pro většinu uživatelů jednodušší a flexibilnější prostředí.

Command Účel Installation Scope
dotnet tool exec Provedení s jedním snímkem Žádné (pouze v mezipaměti) Temporary
dotnet tool install -g Trvalá globální instalace Global Systémová
dotnet tool install Trvalá místní instalace Místní manifest Projekt
dotnet tool run Spuštění již nainstalovaného místního nástroje Vyžaduje předchozí instalaci. Projekt

Příkaz dotnet tool install -g stále slouží k důležitému účelu pro uživatele, kteří chtějí trvale nainstalovat nástroj. Pro uživatele, kteří chtějí vyzkoušet nástroj nebo ho spustit v kanálu CI/CD, dotnet tool exec je ale často vhodnější.

Viz také

  • Last updated on