dotnet tool install

Dieser Artikel gilt für: ✔️ .NET Core 2.1 SDK und neuere Versionen

name

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

Übersicht

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

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

dotnet tool install <PACKAGE_NAME> [--local]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--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.

Lokale Tools sind ab .NET Core SDK 3.0 verfügbar.

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

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

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 sie, 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

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

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

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

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.

Siehe auch