.NET Core CLI 도구 설명서 dotnet-install 스크립트 참조

이름

dotnet-install.ps1 | dotnet-install.sh - 명령줄 인터페이스(CLI) 도구 설치를 위한 스크립트 및 공유 런타임

요약

Windows:

dotnet-install.ps1 [-채널] [-Version] [-InstallDir] [-Debug] [-NoPath] [-SharedRuntime]

OS X/Linux:

dotnet-install.sh [--채널] [--버전] [--install-dir] [--debug] [--no-path] [--shared-runtime]

설명

dotnet-install 설치 스크립트는 CLI 도구 체인 및 공유 런타임의 비관리자 설치를 수행하는 데 사용됩니다. CLI GitHub 리포지토리에서 스크립트를 다운로드할 수 있습니다.

주로 자동화 시나리오 및 비관리자 설치를 돕는 데 사용됩니다. 두 개의 스크립트가 있습니다. 하나는 Windows에서 작동하는 PowerShell이고 다른 하나는 Linux/OS X에서 작동하는 bash 스크립트입니다. 둘 다 동일한 동작을 수행합니다. Bash 스크립트는 또한 PowerShell 스위치를 "이해"하므로 전반적으로 사용할 수 있습니다.

설치 스크립트는 CLI에서 ZIP/tarball 파일을 다운로드하여 생성되며 기본 위치 또는 --install-dir에서 지정한 위치에 설치됩니다. 기본적으로 설치 스크립트는 SDK를 다운로드하여 설치합니다. 공유 런타임만 얻으려는 경우 --shared-runtime 매개변수를 지정할 수 있습니다.

기본적으로 설치 스크립트는 현재 세션의 $PATH에 설치 위치를 추가합니다. --no-path 매개변수를 사용하는 경우 이는 재정의될 수 있습니다.

스크립트를 실행하기 전에 필요한 모든 종속성을 설치하세요.

--version 매개변수를 사용하여 특정 버전을 설치할 수 있습니다. 지정된 버전에는 3부분으로 구성된 버전이 필요합니다(예: 1.0.0-13232). 생략하면 호출된 스크립트의 상위 폴더에 있는 sdkVersion 노드가 포함된 첫 번째 global.json 파일이 기본값이 됩니다. 존재하지 않는 경우 최신 항목을 사용합니다.

또한 이 스크립트를 사용하면 --debug 인수를 사용하여 SDK용 디버그 바이너리 또는 공유 런타임 디버깅 기호를 얻을 수도 있습니다. 처음 설치할 때 이 작업을 수행하지 않고 나중에 실제로 디버깅 기호가 필요한 경우 이 매개변수와 설치한 버전을 사용하여 스크립트를 다시 실행할 수 있습니다.

옵션

다양한 스크립트 구현을 위한 옵션입니다.

PowerShell(Windows)

-채널 [CHANNEL]

설치할 채널입니다(예: "future", "preview", "production"). 기본 버전은 "프로덕션"입니다.

-버전 [VERSION]

설치된 CLI 버전입니다. 3부분으로 구성된 버전을 지정해야 합니다(예: 1.0.0-13232). 생략하면 호출된 스크립트의 상위 폴더에 있는 sdkVersion 노드가 포함된 첫 번째 global.json 파일이 기본값이 됩니다. 존재하지 않는 경우 최신 항목을 사용합니다.

-InstallDir [DIR]

설치 경로입니다. 디렉터리가 없으면 만듭니다. 기본값은 %LocalAppData%.dotnet입니다.

-디버그

true는 디버깅 기호가 포함된 더 큰 패키지를 사용해야 함을 나타내고, 그렇지 않으면 false입니다. 기본값은 false입니다.

-NoPath

true는 접두사/설치 디렉터리가 현재 세션의 경로로 내보내지지 않음을 나타내고, 그렇지 않으면 false입니다. 기본값은 false입니다. 즉, PATH가 수정됩니다. 이렇게 하면 설치 후 즉시 CLI 도구를 사용할 수 있습니다.

-SharedRuntime

true는 공유 런타임만 설치합니다. false는 전체 SDK를 설치합니다. 기본값은 false입니다.

Bash(OS X/Linux)

--채널 [CHANNEL]

설치할 채널(예: "future", "preview", "production") ). 기본 버전은 "프로덕션"입니다.

--버전 [VERSION]

설치된 CLI 버전입니다. 3부분으로 구성된 버전을 지정해야 합니다(예: 1.0.0-13232). 생략하면 sdkVersion 노드가 포함된 첫 번째 global.json 파일이 기본값이 됩니다. 존재하지 않는 경우 최신 항목을 사용합니다.

--install-dir [DIR]

설치 경로입니다. 디렉터리가 없으면 만듭니다. 기본값은 %HOME%/.dotnet입니다.

--debug

true는 디버깅 기호가 포함된 더 큰 패키지를 사용해야 함을 나타내고, 그렇지 않으면 false입니다. 기본값은 false입니다.

--no-path

true는 접두사/설치 디렉터리가 현재 세션의 경로로 내보내지지 않음을 나타내고, 그렇지 않으면 false입니다. 기본값은 false입니다. 즉, PATH가 수정됩니다. 이렇게 하면 설치 후 즉시 CLI 도구를 사용할 수 있습니다.

--shared-runtime

true는 공유 런타임만 설치합니다. false는 전체 SDK를 설치합니다. 기본값은 false입니다.

예

Windows:

./dotnet-install.ps1 -Channel Future

OS X/Linux:

./dotnet-install.sh --channel Future

최신 개발 버전을 기본 위치에 설치합니다.

Windows:

./dotnet-install.ps1 -채널 미리보기 -InstallDir C:cli

OS X/Linux:

./dotnet-install.sh --channel Preview --install-dir ~/cli

지정된 위치에 최신 미리보기 버전을 설치합니다.