dotnet tool installdotnet tool install

Dieser Artikel gilt für: ✔️ .NET Core 2.1 SDK und neuere VersionenThis article applies to: ✔️ .NET Core 2.1 SDK and later versions

nameName

dotnet tool install: Installiert das angegebene .NET Core-Tool auf Ihrem Computer.dotnet tool install - Installs the specified .NET Core tool on your machine.

ÜbersichtSynopsis

dotnet tool install <PACKAGE_NAME> -g|--global
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--framework <FRAMEWORK>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--framework <FRAMEWORK>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME>
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--framework <FRAMEWORK>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

BeschreibungDescription

Der Befehl dotnet tool install ermöglicht Ihnen das Installieren von .NET Core-Tools auf Ihrem Computer.The dotnet tool install command provides a way for you to install .NET Core tools on your machine. Um den Befehl zu verwenden, geben Sie eine der folgenden Installationsoptionen an:To use the command, you specify one of the following installation options:

  • Verwenden Sie zum Installieren eines globalen Tools am Standardspeicherort die Option --global.To install a global tool in the default location, use the --global option.
  • Verwenden Sie zum Installieren eines globalen Tools an einem benutzerdefinierten Speicherort die Option --tool-path.To install a global tool in a custom location, use the --tool-path option.
  • Wenn Sie ein lokales Tool installieren möchten, lassen Sie die Optionen --global und --tool-path weg.To install a local tool, omit the --global and --tool-path options.

Lokale Tools sind ab .NET Core SDK 3.0 verfügbar.Local tools are available starting with .NET Core SDK 3.0.

Globale Tools werden standardmäßig in den folgenden Verzeichnissen installiert, wenn Sie die Option -g oder --global angeben:Global tools are installed in the following directories by default when you specify the -g or --global option:

BetriebssystemOS PfadPath
Linux/macOSLinux/macOS $HOME/.dotnet/tools
WindowsWindows %USERPROFILE%\.dotnet\tools

Lokale Tools werden der Datei dotnet-tools.json im Verzeichnis .config unter dem aktuellen Verzeichnis hinzugefügt.Local tools are added to a dotnet-tools.json file in a .config directory under the current directory. Wenn noch keine Manifestdatei vorhanden ist, erstellen Sie sie, indem Sie den folgenden Befehl ausführen:If a manifest file doesn't exist yet, create it by running the following command:

dotnet new tool-manifest

Weitere Informationen finden Sie unter Installieren eines lokalen Tools.For more information, see Install a local tool.

ArgumenteArguments

  • PACKAGE_NAME

    Name oder ID des NuGet-Pakets, das das zu installierende .NET Core-Tool enthält.Name/ID of the NuGet package that contains the .NET Core tool to install.

OptionenOptions

  • add-source <SOURCE>

    Fügt eine zusätzliche NuGet-Paketquelle für die Installation hinzu.Adds an additional NuGet package source to use during installation.

  • configfile <FILE>

    Die zu verwendende NuGet-Konfigurationsdatei (nuget.config).The NuGet configuration (nuget.config) file to use.

  • framework <FRAMEWORK>

    Legt das Zielframework des zu installierenden Tools fest.Specifies the target framework to install the tool for. Das .NET Core SDK versucht standardmäßig, das am besten geeignete Zielframework auszuwählen.By default, the .NET Core SDK tries to choose the most appropriate target framework.

  • -g|--global

    Gibt an, dass die Installation benutzerweit ist.Specifies that the installation is user wide. Kann nicht mit der Option --tool-path kombiniert werden.Can't be combined with the --tool-path option. Durch Weglassen von --global und --tool-path wird die Installation eines lokalen Tools angegeben.Omitting both --global and --tool-path specifies a local tool installation.

  • -h|--help

    Druckt eine kurze Hilfe für den Befehl.Prints out a short help for the command.

  • tool-path <PATH>

    Gibt den Speicherort des globalen Tools an, das installiert wird.Specifies the location where to install the Global Tool. „PATH“ kann absolut oder relativ sein.PATH can be absolute or relative. Wenn kein Pfad vorhanden ist, versucht der Befehl, ihn zu erstellen.If PATH doesn't exist, the command tries to create it. Durch Weglassen von --global und --tool-path wird die Installation eines lokalen Tools angegeben.Omitting both --global and --tool-path specifies a local tool installation.

  • -v|--verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad für den Befehl fest.Sets the verbosity level of the command. Zulässige Werte sind q[uiet], m[inimal], n[ormal], d[etailed] und diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic].

  • --version <VERSION_NUMBER>

    Die Version des zu installierenden Tools.The version of the tool to install. Standardmäßig wird die neueste stabile Paketversion installiert.By default, the latest stable package version is installed. Verwenden Sie diese Optionen zum Installieren von Vorschau- oder früheren Versionen des Tools.Use this option to install preview or older versions of the tool.

BeispieleExamples

  • dotnet tool install -g dotnetsay

    Installiert dotnetsay als globales Tool am Standardspeicherort.Installs dotnetsay as a global tool in the default location.

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

    Installiert dotnetsay als globales Tool in einem bestimmten Windows-Verzeichnis.Installs dotnetsay as a global tool in a specific Windows directory.

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

    Installiert dotnetsay als globales Tool in einem bestimmten Linux/macOS-Verzeichnis.Installs dotnetsay as a global tool in a specific Linux/macOS directory.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Installiert Version 2.0.0 von dotnetsay als globales Tool.Installs version 2.0.0 of dotnetsay as a global tool.

  • dotnet tool install dotnetsay

    Installiert dotnetsay als lokales Tool im aktuellen Verzeichnis.Installs dotnetsay as a local tool for the current directory.

Siehe auchSee also