dotnet tool install

  • Artikel

Dieser Artikel gilt für: ✔️ .NET Core 3.1 SDK und höher

Name

dotnet tool install: Der Befehl installiert das angegebene .NET-Tool auf Ihrem Computer.

Übersicht

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Beschreibung

Der Befehl dotnet tool install ermöglicht Ihnen das Installieren von .NET-Tools auf Ihrem Computer. Um den Befehl zu verwenden, geben Sie eine der folgenden Installationsoptionen an:

  • Verwenden Sie zum Installieren eines globalen Tools am Standardspeicherort die Option --global.
  • Verwenden Sie zum Installieren eines globalen Tools an einem benutzerdefinierten Speicherort die Option --tool-path.
  • Wenn Sie ein lokales Tool installieren möchten, lassen Sie die Optionen --global und --tool-path weg.

Installationsorte

Globale Tools

Globale Tools werden standardmäßig in den folgenden Verzeichnissen installiert, wenn Sie die Option -g oder --global angeben:

Betriebssystem Path
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Die ausführbaren Dateien für jedes global installierte Tool werden in diesen Ordnern generiert. Die eigentlichen Binärdateien der Tools sind jedoch tief in das gleichgeordnete Verzeichnis .store geschachtelt.

Hinweis

Unter Linux nach der Installation eines Befehlszeilentools mit dotnet tool, kann das Tool nur aus dem $HOME/.dotnet/tools Pfad ausgeführt werden. Um das Tool aus einem beliebigen Verzeichnis ausführbar zu machen, aktualisieren Sie die PATH Umgebungsvariable. Um die aktualisierte PATH Umgebungsvariable dauerhaft in Der Shell zu erstellen, aktualisieren Sie die Shelleinstellungen. Für Bash, ist dies die $HOME/.bashrc Datei.

--tool-path-Tools

Tools mit expliziten Toolpfaden werden genau an dem Ort gespeichert, den Sie im Parameter --tool-path als Ziel angegeben haben. Sie werden auf die gleiche Weise wie globale Tools gespeichert: eine ausführbare Binärdatei mit den eigentlichen Binärdateien in einem gleichgeordneten Verzeichnis .store.

Lokale Tools

Lokale Tools werden in dem globalen NuGet-Verzeichnis gespeichert, das Sie festgelegt haben. Für jedes lokale Tool gibt es in $HOME/.dotnet/toolResolverCache Shimdateien die darauf verweisen, wo sich die Tools an diesem Speicherort befinden.

Verweise auf lokale Tools werden der Datei dotnet-tools.json im Verzeichnis .config unter dem aktuellen Verzeichnis hinzugefügt. Wenn noch keine Manifestdatei vorhanden ist, erstellen Sie diese mithilfe der Option --create-manifest-if-needed, oder indem Sie den folgenden Befehl ausführen:

dotnet new tool-manifest

Weitere Informationen finden Sie unter Installieren eines lokalen Tools.

Argumente

  • PACKAGE_NAME

    Der Name oder die ID des NuGet-Pakets, das das zu installierende .NET-Tool enthält

Optionen

  • --allow-downgrade

    Paketdowngrade beim Installieren oder Aktualisieren eines .NET-Toolpakets zulassen. Unterdrückt die Warnung: "Die angeforderte Version x.x.x ist niedriger als die vorhandene Version x.x.x."

  • -a|--arch <ARCHITECTURE>

    Legt die Zielarchitektur fest. Dies ist eine Kurzsyntax zum Setzen des Runtimebezeichners (RID), wobei der angegebene Wert mit dem Standard-RID kombiniert wird. Auf einem win-x64 Rechner wird beispielsweise durch die Angabe von --arch x86 der RID auf win-x86 gesetzt.

  • --add-source <SOURCE>

    Fügt eine zusätzliche NuGet-Paketquelle für die Installation hinzu. Der Zugriff auf Feeds erfolgt parallel und nicht sequenziell in einer Rangfolge. Wenn sich das gleiche Paket und die gleiche Version in mehreren Feeds befinden, gewinnt der schnellste Feed. Weitere Informationen finden Sie unter Was geschieht bei der NuGet-Paketinstallation?.

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

  • --create-manifest-if-needed

    Gilt für lokale Tools. Verfügbar ab .NET 8 SDK. Um ein Manifest zu finden, durchsucht der Suchalgorithmus die Verzeichnisstruktur nach oben nach dotnet-tools.json oder einem .config-Ordner, der eine dotnet-tools.json -Datei enthält.

    Wenn kein Toolmanifest gefunden wird und die Option --create-manifest-if-needed auf „false“ festgelegt ist, tritt der Fehler CannotFindAManifestFile auf.

    Wenn kein Toolmanifest gefunden wird und die Option --create-manifest-if-needed auf „true“ festgelegt ist, erstellt das Tool automatisch ein Manifest. Es wählt wie folgt einen Ordner für das Manifest aus:

    • Die Verzeichnisstruktur wird nach oben durchlaufen, um nach einem Verzeichnis zu suchen, das einen .git-Unterordner enthält. Wenn ein Verzeichnis gefunden wird, wird das Manifest in diesem Verzeichnis erstellt.
    • Wenn im vorherigen Schritt kein Verzeichnis gefunden wird, führen Sie die Verzeichnisstruktur durch, die nach einem Verzeichnis sucht, das eine oder .git eine .sln Datei enthält. Wenn ein Verzeichnis gefunden wird, wird das Manifest in diesem Verzeichnis erstellt.
    • Wenn keiner der vorherigen beiden Schritte ein Verzeichnis findet, wird das Manifest im aktuellen Arbeitsverzeichnis erstellt.

    Weitere Informationen dazu, wie sich Manifeste befinden, finden Sie unter Installieren eines lokalen Tools.

  • --disable-parallel

    Verhindert die parallele Wiederherstellung mehrerer Projekte.

  • --framework <FRAMEWORK>

    Legt das Zielframework des zu installierenden Tools fest. Das .NET SDK versucht standardmäßig, das am besten geeignete Zielframework auszuwählen.

  • -g|--global

    Gibt an, dass die Installation benutzerweit ist. Kann nicht mit der Option --tool-path kombiniert werden. Durch Weglassen von --global und --tool-path wird die Installation eines lokalen Tools angegeben.

  • -?|-h|--help

    Gibt eine Beschreibung zur Verwendung des Befehls aus.

  • --ignore-failed-sources

    Paketquellenfehler werden als Warnungen behandelt.

  • --interactive

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

  • --local

    Aktualisieren Sie das Tool und das lokale Toolmanifest. Kann nicht mit der Option --global oder der Option --tool-path kombiniert werden.

  • --no-cache

    Pakete und HTTP-Anforderungen werden nicht zwischengespeichert.

  • --prerelease

    Schließen Sie Vorabversionspakete ein.

  • --tool-manifest <PATH>

    Pfad zur Manifestdatei.

  • --tool-path <PATH>

    Gibt den Speicherort des globalen Tools an, das installiert wird. „PATH“ kann absolut oder relativ sein. Wenn kein Pfad vorhanden ist, versucht der Befehl, ihn zu erstellen. Durch Weglassen von --global und --tool-path wird die Installation eines lokalen Tools angegeben.

  • -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]. Weitere Informationen finden Sie unter LoggerVerbosity.

  • --version <VERSION_NUMBER>

    Die Version des zu installierenden Tools. Standardmäßig wird die neueste stabile Paketversion installiert. Verwenden Sie diese Optionen zum Installieren von Vorschau- oder früheren Versionen des Tools.

    Ab .NET 8.0 bezieht sich --version Major.Minor.Patch auf eine bestimmte Haupt-/Neben-/Patchversion, einschließlich nicht aufgelisteter Versionen. Um stattdessen die neueste Version einer bestimmten Haupt-/Nebenversion zu erhalten, verwenden Sie --version Major.Minor.*.

Beispiele

  • dotnet tool install -g dotnetsay

    Installiert dotnetsay als globales Tool am Standardspeicherort.

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

    Installiert dotnetsay als globales Tool in einem bestimmten Windows-Verzeichnis.

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

    Installiert dotnetsay als globales Tool in einem bestimmten Linux/macOS-Verzeichnis.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Installiert Version 2.0.0 von dotnetsay als globales Tool.

  • dotnet tool install dotnetsay

    Installiert dotnetsay als lokales Tool im aktuellen Verzeichnis.

  • dotnet tool install -g --verbosity minimal

    Installiert dotnetsay als globales Tool mit der Ausführlichkeit minimal. Die standardmäßige Ausführlichkeit für globale Tools ist gering.

Siehe auch