Tutorial: Installieren und Verwenden eines globalen .NET-Tools mithilfe der .NET-CLI

Artikel
07/31/2023

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

In diesem Tutorial erfahren Sie, wie ein globales Tools installiert und verwendet wird. Sie verwenden ein Tool, das Sie im ersten Tutorial dieser Reihe erstellen.

Voraussetzungen

Absolvieren Sie das erste Tutorial dieser Reihe.

Verwenden des Tools als globales Tool

Installieren Sie das Tool aus dem Paket, indem Sie den Befehl dotnet tool install im Projektordner microsoft.botsay ausführen:
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
Der Parameter --global weist die .NET-CLI an, die Binärdateien des Tools an einem Standardspeicherort zu installieren, der automatisch zur Umgebungsvariablen PATH hinzugefügt wird.

Der Parameter --add-source weist die .NET-CLI an, vorübergehend das Verzeichnis ./nupkg als zusätzlichen Quellfeed für NuGet-Pakete zu verwenden. Sie haben Ihr Paket mit einem eindeutigen Namen versehen, um sicherzustellen, dass es nur im Verzeichnis ./nupkg und nicht auf der Website Nuget.org gefunden wird.

Die Ausgabe zeigt den zum Aufrufen des Tools verwendeten Befehl und die installierte Version:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Hinweis

Standardmäßig stellt die Architektur der zu installierenden .NET-Binärdateien die derzeit ausgeführte Betriebssystemarchitektur dar. Informationen zum Angeben einer anderen Betriebssystemarchitektur finden Sie unter dotnet tool install, --arch (Option).
Rufen Sie das Tool auf:
```
botsay hello from the bot
```
Hinweis

Wenn dieser Befehl fehlschlägt, müssen Sie möglicherweise ein neues Terminal öffnen, um PATH zu aktualisieren.
Entfernen Sie das Tool, indem Sie den Befehl dotnet tool uninstall ausführen:
```
dotnet tool uninstall -g microsoft.botsay
```

Verwenden des an einem benutzerdefinierten Speicherort installierten Tools als globales Tool

Installieren Sie das Toll aus dem Paket.

Unter Windows:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg microsoft.botsay
```
Unter Linux oder macOS:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay
```
Der Parameter --tool-path weist die .NET-CLI an, die Binärdateien des Tools am angegebenen Speicherort zu installieren. Wenn das Verzeichnis noch nicht vorhanden ist, wird es erstellt. Dieses Verzeichnis wird nicht automatisch zur Umgebungsvariablen PATH hinzugefügt.

Die Ausgabe zeigt den zum Aufrufen des Tools verwendeten Befehl und die installierte Version:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Rufen Sie das Tool auf:

Unter Windows:

c:\dotnet-tools\botsay hello from the bot

Unter Linux oder macOS:

~/bin/botsay hello from the bot

Entfernen Sie das Tool, indem Sie den Befehl dotnet tool uninstall ausführen:

Unter Windows:

dotnet tool uninstall --tool-path c:\dotnet-tools microsoft.botsay

Unter Linux oder macOS:

dotnet tool uninstall --tool-path ~/bin microsoft.botsay

Problembehandlung

Falls im Verlauf des Tutorials eine Fehlermeldung angezeigt wird, finden Sie unter Behandlung von Problemen bei der Nutzung von .NET-Tools weitere Informationen.

Nächste Schritte

In diesem Tutorial haben Sie ein Tool als globales Tool installiert und verwendet. Weitere Informationen zum Installieren und Verwenden globaler Tools finden Sie unter Verwalten globaler Tools. Um dasselbe Tool als lokales Tool zu installieren und zu verwenden, fahren Sie mit dem nächsten Tutorial fort.

Installieren und Verwenden lokaler Tools