Freigeben über

dotnet tool exec

Dieser Artikel bezieht sich auf: ✔️ .NET 10.0.100 SDK und höhere Versionen

Name

dotnet tool exec – Lädt ein .NET-Tool herunter und ruft es auf, ohne es dauerhaft zu installieren.

Zusammenfassung

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

Der dotnet tool exec Befehl stellt einen Einschusstoolaufrufmodus für .NET-Tools bereit. Es lädt das angegebene Toolpaket automatisch in den NuGet-Cache herunter und ruft es auf, ohne ihr System PATH zu ändern oder eine dauerhafte Installation zu erfordern.

Wenn Sie ausgeführt werden dotnet tool exec, lautet der Befehl:

  1. Überprüft die version (oder den Versionsbereich), die Sie angeben (oder die neueste Version, wenn keine angegeben ist) anhand Ihrer konfigurierten NuGet-Feeds, um zu entscheiden, welches Paket heruntergeladen werden soll.
  2. Lädt das angegebene Paket in den NuGet-Cache herunter (sofern noch nicht vorhanden).
  3. Ruft das Tool mit allen bereitgestellten Argumenten auf.
  4. Gibt den Beendigungscode des Tools zurück.

dotnet tool exec arbeitet nahtlos mit globalen und lokalen Tools zusammen. Wenn Sie über ein lokales Toolmanifest verfügen, wird das Manifest verwendet, um zu bestimmen, welche Version des Tools ausgeführt werden soll.

Dieser Befehl ist auch in zwei anderen Formen vorhanden, um die Verwendung zu erleichtern.

  • dotnet dnx – Ein ausgeblendeter Alias, der dotnet tool exec als Möglichkeit zum einfachen Implementieren des dnx Skripts verwendet wird
  • dnx – Ein Shellskript, das aus dem SDK aufgerufen wird dotnet dnx . Dieses Skript wird vom Installationsprogramm bereitgestellt und ist verfügbar auf PATH. Es ermöglicht eine sehr einfache Verwendung von Tools direkt über dnx <toolname>.

Arguments

  • PACKAGE_NAME

    Die NuGet-Paket-ID des auszuführenden .NET-Tools. Sie können optional eine Version mithilfe der @ Syntax angeben, z. B dotnetsay@2.1.0. .

  • tool-arguments

    Argumente, die an das auszuführende Tool übergeben werden sollen. Alles, nachdem -- direkt an das Tool übergeben wurde.

Options

  • --allow-roll-forward

    Zulassen, dass das Tool eine neuere Version der .NET-Laufzeit verwendet, wenn die Laufzeit, auf die es abzielt, nicht installiert ist.

  • --add-source <SOURCE>

    Fügt eine zusätzliche NuGet-Paketquelle für die Installation hinzu. Auf Feeds wird parallel zugegriffen, nicht in einer Fallbackkaskadensequenz. Wenn dasselbe Paket und dieselbe Version in mehreren Feeds verfügbar sind, gewinnt der schnellste Feed. Weitere Informationen finden Sie unter Was passiert, wenn ein NuGet-Paket installiert ist. Sie können dies über die Verwendung der NuGet-Paketquellzuordnung steuern. Weitere Informationen finden Sie unter Package Source Mapping.

  • --configfile <FILE>

    Die zu verwendende NuGet-Konfigurationsdatei (nuget.config). Sofern angegeben, werden nur die Einstellungen aus dieser Datei verwendet. Falls nicht angegeben, wird die Hierarchie der Konfigurationsdateien aus dem aktuellen Verzeichnis verwendet. Weitere Informationen finden Sie unter Gängige NuGet-Konfigurationen.

  • --disable-parallel

    Diese Option verhindert die parallele Wiederherstellung mehrerer Projekte.

  • --ignore-failed-sources

    Behandelt Paketquellenfehler als Warnungen.

  • --interactive

    Ermöglicht dem Befehl, anzuhalten und auf Benutzereingaben oder Aktionen zu warten. Beispielsweise, um die Authentifizierung abzuschließen.

  • --no-http-cache

    Speichert keine HTTP-Anforderungen an die konfigurierten NuGet-Feeds.

  • --prerelease

    Ermöglicht die Auswahl von Vorabpaketen beim Auflösen der zu installierenden Version.

  • --source <SOURCE>

    Gibt die Quelle für NuGet-Pakete an.

  • -v|--verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad für den Befehl fest. Zulässige Werte sind q[uiet], m[inimal], n[ormal], d[etailed] und diag[nostic]. Der Standardwert lautet normal. Weitere Informationen finden Sie unter LoggerVerbosity.

  • -?|-h|--help

    Gibt eine Beschreibung zur Verwendung des Befehls aus.

Examples

  • dotnet tool exec dotnetsay

    Lädt (falls erforderlich) herunter und führt die neueste Version des dotnetsay Tools aus.

  • dotnet tool exec dotnetsay@2.1.0

    Downloads (falls erforderlich) und führt Version 2.1.0 des dotnetsay Tools aus.

  • dotnet tool exec dotnetsay@2.*

    Lädt (falls erforderlich) herunter und führt die neueste Version des dotnetsay Tools im Versionsbereich von 2.x aus.

  • dotnet tool exec dotnetsay -- Hello World

    Führt das dotnetsay Tool aus und übergibt "Hello World" als Argumente an das Tool.

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

    Lädt herunter und wird mit der angegebenen NuGet-Quelle ausgeführt mytool .

Vergleich mit anderen Befehlen

Dieser Befehl soll eine einheitliche Möglichkeit zum Arbeiten mit .NET Tools sein. Während die zuvor verfügbaren Toolinstallationsbefehle weiterhin verfügbar sind, dotnet tool exec bietet dies eine einfachere und flexiblere Benutzeroberfläche für die meisten Benutzer.

Command Zweck Installation Umfang
dotnet tool exec One-Shot-Ausführung Keine (nur zwischengespeichert) Temporary
dotnet tool install -g Permanente globale Installation Global Systemweit
dotnet tool install Dauerhafte lokale Installation Lokales Manifest Project
dotnet tool run Ausführen eines bereits installierten lokalen Tools Erfordert eine vorherige Installation Project

Der dotnet tool install -g Befehl dient weiterhin einem wichtigen Zweck für Benutzer, die ein Tool dauerhaft installieren möchten. Für Benutzer, die ein Tool ausprobieren oder in einer CI/CD-Pipeline ausführen möchten, dotnet tool exec ist dies häufig besser geeignet.

Siehe auch

  • Last updated on