자습서: .NET CLI를 사용하여 .NET 전역 도구 설치 및 사용

이 문서의 적용 대상: ✔️ .NET Core 2.1 SDK 이상 버전

이 자습서에서는 전역 도구를 설치하고 사용하는 방법을 설명합니다. 이 시리즈의 첫 번째 자습서에서 만든 도구를 사용합니다.

필수 조건

microsoft.botsay 프로젝트 폴더에서 dotnet tool install 명령을 실행하여 패키지에서 도구를 설치합니다.
```
dotnet tool install --global --add-source ./nupkg microsoft.botsay
```
--global 매개 변수는 PATH 환경 변수에 자동으로 추가되는 기본 위치에 도구 이진 파일을 설치하도록 .NET CLI에 지시합니다.

--add-source 매개 변수는 NuGet 패키지의 추가 소스 피드로 ./nupkg 디렉터리를 임시로 사용하도록 .NET CLI에 지시합니다. 패키지에 고유한 이름을 지정하여 Nuget.org 사이트가 아니라 /nupkg 디렉터리에서만 찾을 수 있는지 확인합니다.

출력에서는 설치된 도구 및 버전을 호출하는 데 사용되는 명령을 보여 줍니다.
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
참고 항목

기본적으로 설치할 .NET 이진 파일의 아키텍처는 현재 실행 중인 OS 아키텍처를 나타냅니다. 다른 OS 아키텍처를 지정하려면 dotnet 도구 설치, --arch 옵션을 참조하세요.
도구를 호출합니다.
```
botsay hello from the bot
```
참고 항목

이 명령이 실패하는 경우 PATH를 새로 고치기 위해 새 터미널을 열어야 할 수도 있습니다.
dotnet tool uninstall 명령을 실행하여 도구를 제거합니다.
```
dotnet tool uninstall -g microsoft.botsay
```

도구를 호출합니다.

Windows에서:

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

Linux 또는 macOS에서:

~/bin/botsay hello from the bot

dotnet tool uninstall 명령을 실행하여 도구를 제거합니다.

Windows에서:

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

Linux 또는 macOS에서:

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

자습서를 수행하는 동안 오류 메시지가 표시되는 경우 .NET 도구 사용 문제 해결을 참조하세요.

이 자습서에서는 도구를 전역 도구로 설치하고 사용했습니다. 전역 도구를 설치하고 사용하는 방법에 대한 자세한 내용은 전역 도구 관리를 참조하세요. 로컬 도구와 동일한 도구를 설치하고 사용하려면 다음 자습서로 이동합니다.