dotnet tool exec

이 문서는 .NET 10.0.100 SDK 이상 버전에 적용됩니다 ✔️.

이름

dotnet tool exec - 영구적으로 설치하지 않고 .NET 도구를 다운로드하고 호출합니다.

개요

dotnet tool exec <PACKAGE_NAME>[@<VERSION>]
    [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-http-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Description

이 dotnet tool exec 명령은 .NET 도구에 대한 원샷 도구 호출 모드를 제공합니다. 지정된 도구 패키지를 NuGet 캐시에 자동으로 다운로드하고 시스템을 PATH 수정하거나 영구 설치를 요구하지 않고 호출합니다.

실행할 때 다음 명령을 실행 dotnet tool exec합니다.

1. 구성된 NuGet 피드에 대해 지정한 버전(또는 버전 범위)(또는 지정되지 않은 경우 최신 버전)을 확인하여 다운로드할 패키지를 결정합니다.
2. 지정된 패키지를 NuGet 캐시에 다운로드합니다(아직 없는 경우).
3. 제공된 인수를 사용하여 도구를 호출합니다.
4. 도구의 종료 코드를 반환합니다.

dotnet tool exec 는 전역 및 로컬 도구 모두에서 원활하게 작동합니다. 사용할 수 있는 로컬 도구 매니페스트가 있는 경우 매니페스트를 사용하여 실행할 도구의 버전을 결정합니다.

이 명령은 더 쉽게 사용할 수 있는 두 가지 다른 형식에도 있습니다.

• dotnet dnx- 스크립트 자체를 쉽게 구현 dotnet tool exec 하는 방법으로 사용되는 숨겨진 별칭 dnx
• dnx - SDK에서 호출하는 dotnet dnx 셸 스크립트입니다. 이 스크립트는 설치 관리자가 제공하며 .PATH 을 통해 dnx <toolname>직접 도구를 매우 간단하게 사용할 수 있습니다.

Arguments

• PACKAGE_NAME

  실행할 .NET 도구의 NuGet 패키지 ID입니다. 필요에 따라 구문을 사용하여 @ 버전을 지정할 수 있습니다. 예를 들면 다음과 같습니다 dotnetsay@2.1.0.

• tool-arguments

  실행 중인 도구에 전달할 인수입니다. 이후 -- 의 모든 항목은 도구에 직접 전달됩니다.

Options

• --allow-roll-forward

  대상으로 하는 런타임이 설치되지 않은 경우 도구에서 최신 버전의 .NET 런타임을 사용하도록 허용합니다.

• --add-source <SOURCE>

  설치 중에 사용할 추가 NuGet 패키지 원본을 추가합니다. 피드는 대체 캐스케이드 시퀀스가 아니라 병렬로 액세스됩니다. 여러 피드에서 동일한 패키지와 버전을 사용할 수 있는 경우 가장 빠른 피드가 우선합니다. 자세한 내용은 NuGet 패키지가 설치될 때 발생하는 동작을 참조하세요. NuGet 패키지 원본 매핑을 사용하여 이를 제어할 수 있습니다. 자세한 내용은 패키지 원본 매핑을 참조하세요.

• --configfile <FILE>

  사용할 NuGet 구성 파일(nuget.config)입니다. 지정된 경우 이 파일의 설정만 사용됩니다. 지정되지 않으면 현재 디렉터리의 구성 파일의 계층 구조가 사용됩니다. 자세한 내용은 일반적인 NuGet 구성을 참조하세요.

• --disable-parallel

  여러 프로젝트를 병렬로 복원하는 것을 방지합니다.

• --ignore-failed-sources

  패키지 원본 오류를 경고로 처리합니다.

• --interactive

  명령이 중지되고 사용자 입력 또는 작업을 대기할 수 있도록 허용합니다. 예를 들어 인증을 완료합니다.

• --no-http-cache

  구성된 NuGet 피드에 HTTP 요청을 캐시하지 않습니다.

• --prerelease

  설치할 버전을 확인할 때 시험판 패키지를 선택할 수 있습니다.

• --source <SOURCE>

  NuGet 패키지의 원본을 지정합니다.

• -v|--verbosity <LEVEL>

  명령의 세부 정보 표시 수준을 설정합니다. 허용되는 값은 q[uiet], m[inimal], n[ormal], d[etailed], diag[nostic]입니다. 기본값은 normal입니다. 자세한 내용은 LoggerVerbosity를 참조하세요.

• -?|-h|--help

  명령을 사용하는 방법에 대한 설명을 출력합니다.

예시

• dotnet tool exec dotnetsay

  필요한 경우 다운로드하고 최신 버전의 도구를 실행합니다 dotnetsay .

• dotnet tool exec dotnetsay@2.1.0

  필요한 경우 다운로드하고 도구 버전 2.1.0을 dotnetsay 실행합니다.

• dotnet tool exec dotnetsay@2.*

  필요한 경우 다운로드하고 2.x 버전 dotnetsay 범위에서 최신 버전의 도구를 실행합니다.

• dotnet tool exec dotnetsay -- Hello World

  dotnetsay 도구를 실행하고 "Hello World"를 도구에 인수로 전달합니다.

• dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool

  지정된 NuGet 원본을 사용하여 다운로드하고 실행 mytool 합니다.

다른 명령과의 비교

이 명령은 .NET Tools로 작업하는 통합된 방법을 위한 것입니다. 이전에 사용 가능한 도구 설치 명령은 계속 사용할 수 있지만 dotnet tool exec 대부분의 사용자에게 더 간단하고 유연한 환경을 제공합니다.

Command	목적	설치	Scope
dotnet tool exec	원샷 실행	없음(캐시된 경우에만)	Temporary
dotnet tool install -g	영구 전역 설치	글로벌	시스템 전체
dotnet tool install	영구 로컬 설치	로컬 매니페스트	프로젝트
dotnet tool run	이미 설치된 로컬 도구 실행	사전 설치 필요	프로젝트

이 dotnet tool install -g 명령은 도구를 영구적으로 설치하려는 사용자에게 여전히 중요한 용도로 사용됩니다. 그러나 도구를 사용해 보거나 CI/CD 파이프라인 dotnet tool exec 에서 실행하려는 사용자에게는 종종 더 적합합니다.

참고하십시오

• .NET 도구
• dotnet tool install
• dotnet tool run
• 자습서: .NET CLI를 사용하여 .NET 전역 도구 설치 및 사용
• 자습서: .NET CLI를 사용하여 .NET 로컬 도구 설치 및 사용