다음을 통해 공유


dotnet tool update

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

이름

dotnet tool update - 머신에서 지정된 .NET 도구를 업데이트합니다.

개요

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] 
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

설명

dotnet tool update 명령은 머신의 .NET 도구를 안정적인 최신 버전의 패키지로 업데이트하는 방법을 제공합니다. 이 명령은 도구를 제거하고 다시 설치하여 효과적으로 업데이트합니다. 이 명령을 사용하려면 다음 옵션 중 하나를 지정합니다.

  • 기본 위치에 설치된 전역 도구를 업데이트하려면 --global 옵션을 사용합니다.
  • 사용자 지정 위치에 설치된 전역 도구를 업데이트하려면 --tool-path 옵션을 사용합니다.
  • 로컬 도구를 업데이트하려면 --local 옵션을 사용합니다.

인수

  • PACKAGE_ID

    업데이트할 .NET 전역 도구를 포함하는 NuGet 패키지의 이름/ID입니다. dotnet tool list 명령을 사용하여 패키지 이름을 찾을 수 있습니다.

옵션

  • --add-source <SOURCE>

    설치 중에 사용할 추가 NuGet 패키지 원본을 추가합니다. 피드는 우선 순위에 따라 순차적으로 액세스하는 것이 아니라 병렬로 액세스합니다. 동일한 패키지와 버전이 여러 피드에 있는 경우 가장 빠른 피드가 적용됩니다. 자세한 내용은 NuGet 패키지를 설치하면 어떻게 되나요?를 참조하세요.

  • --allow-downgrade

    .NET 도구 패키지를 설치하거나 업데이트할 때 패키지 다운그레이드를 허용합니다. "요청된 버전 x.x.x가 기존 버전 x.x.x보다 낮습니다."라는 경고를 표시하지 않습니다.

  • --configfile <FILE>

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

  • --disable-parallel

    여러 프로젝트를 병렬로 복원하지 않습니다.

  • --framework <FRAMEWORK>

    도구를 업데이트할 대상 프레임워크를 지정합니다.

  • -g|--global

    업데이트가 사용자 수준 도구에 대한 것임을 지정합니다. --tool-path 옵션과 함께 사용할 수 없습니다. --global--tool-path 옵션을 모두 생략하면 업데이트할 도구로 로컬 도구를 지정합니다.

  • -?|-h|--help

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

  • --ignore-failed-sources

    패키지 소스 오류를 경고로 처리합니다.

  • --interactive

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

  • --local

    도구 및 로컬 도구 매니페스트를 업데이트합니다. --global 옵션 또는 --tool-path 옵션과 함께 사용할 수 없습니다.

  • --no-cache

    패키지 및 HTTP 요청을 캐시하지 않습니다.

  • --prerelease

    시험판 버전을 포함합니다.

  • --tool-manifest <PATH>

    매니페스트 파일 경로입니다.

  • --tool-path <PATH>

    전역 도구가 설치되는 위치를 지정합니다. PATH는 절대적이거나 상대적일 수 있습니다. --global 옵션과 함께 사용할 수 없습니다. --global--tool-path 옵션을 모두 생략하면 업데이트할 도구로 로컬 도구를 지정합니다.

  • -v|--verbosity <LEVEL>

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

  • --version <VERSION>

    업데이트할 도구 패키지의 버전 범위입니다. 버전을 다운그레이드하는 데 사용할 수 없으며, 먼저 최신 버전을 uninstall(제거)해야 합니다.

    .NET 8.0 --version Major.Minor.Patch부터는 목록에 없는 버전을 포함하여 특정 major.minor.patch 버전을 참조합니다. 대신 특정 major.minor 버전의 최신 버전을 얻으려면 --version Major.Minor.*을(를) 사용합니다.

예제

  • dotnet tool update -g dotnetsay

    dotnetsay 전역 도구를 업데이트합니다.

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

    특정 Windows 디렉터리에 있는 dotnetsay 전역 도구를 업데이트합니다.

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

    특정 Linux/macOS 디렉터리에 있는 dotnetsay 전역 도구를 업데이트합니다.

  • dotnet tool update dotnetsay

    현재 디렉터리에 대해 설치된 dotnetsay 로컬 도구를 업데이트합니다.

  • dotnet tool update -g dotnetsay --version 2.0.*

    dotnetsay 전역 도구를 최신 패치 버전(주 버전 2 및 부 버전 0)으로 업데이트합니다.

  • dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

    dotnetsay 전역 도구를 지정된 범위 (> 2.0.0 && < 2.1.4) 내의 최하위 버전으로 업데이트합니다. 2.1.0 버전이 설치됩니다. 유의적 버전 범위에 관한 자세한 내용은 NuGet 패키징 버전 범위를 참조하세요.

참조