dotnet-install 스크립트 참조dotnet-install scripts reference

이름Name

dotnet-install.ps1 | dotnet-install.sh - .NET Core SDK 및 공유 런타임을 설치하는 데 사용되는 스크립트입니다.dotnet-install.ps1 | dotnet-install.sh - Script used to install the .NET Core SDK and the shared runtime.

개요Synopsis

Windows:Windows:

dotnet-install.ps1 [-Architecture <ARCHITECTURE>] [-AzureFeed]
    [-Channel <CHANNEL>] [-DryRun] [-FeedCredential]
    [-InstallDir <DIRECTORY>] [-JSonFile <JSONFILE>]
    [-NoCdn] [-NoPath] [-ProxyAddress] [-ProxyBypassList <LIST_OF_URLS>]
    [-ProxyUseDefaultCredentials] [-Runtime <RUNTIME>]
    [-SkipNonVersionedFiles] [-UncachedFeed] [-Verbose]
    [-Version <VERSION>]

Get-Help ./dotnet-install.ps1

Linux/macOS:Linux/macOS:

dotnet-install.sh  [--architecture <ARCHITECTURE>] [--azure-feed]
    [--channel <CHANNEL>] [--dry-run] [--feed-credential]
    [--install-dir <DIRECTORY>] [--jsonfile <JSONFILE>]
    [--no-cdn] [--no-path] [--runtime <RUNTIME>] [--runtime-id <RID>]
    [--skip-non-versioned-files] [--uncached-feed] [--verbose]
    [--version <VERSION>]

dotnet-install.sh --help

또한 bash 스크립트는 PowerShell 스위치를 읽으므로 Linux/macOS 시스템에서 스크립트와 함께 PowerShell 스위치를 사용할 수 있습니다.The bash script also reads PowerShell switches, so you can use PowerShell switches with the script on Linux/macOS systems.

설명Description

dotnet-install 스크립트는 .NET Core CLI 및 공유 런타임을 포함하는 .NET Core SDK의 비관리자 설치를 수행합니다.The dotnet-install scripts perform a non-admin installation of the .NET Core SDK, which includes the .NET Core CLI and the shared runtime. 다음과 같은 두 가지 스크립트가 있습니다.There are two scripts:

  • Windows에서 작동하는 PowerShell 스크립트A PowerShell script that works on Windows.
  • Linux/macOS에서 작동하는 bash 스크립트A bash script that works on Linux/macOS.

용도Purpose

이 스크립트는 다음과 같은 CI(연속 통합) 시나리오에 사용하기 위한 것입니다.The intended use of the scripts is for Continuous Integration (CI) scenarios, where:

  • 사용자 조작 및 관리자 권한 없이 SDK를 설치해야 합니다.The SDK needs to be installed without user interaction and without admin rights.

  • SDK 설치를 여러 CI 실행 간에 유지할 필요가 없습니다.The SDK installation doesn't need to persist across multiple CI runs.

    일반적인 이벤트 시퀀스는 다음과 같습니다.The typical sequence of events:

    • CI가 트리거됩니다.CI is triggered.
    • CI에서 이러한 스크립트 중 하나를 사용하여 SDK를 설치합니다.CI installs the SDK using one of these scripts.
    • CI에서 작업을 완료하고 SDK 설치를 비롯해 임시 데이터를 지웁니다.CI finishes its work and clears temporary data including the SDK installation.

개발 환경을 설정하거나 앱을 실행하려면 이러한 스크립트가 아니라 설치 관리자를 사용합니다.To set up a development environment or to run apps, use the installers rather than these scripts.

안정적인 버전의 스크립트를 사용하는 것이 좋습니다.We recommend that you use the stable version of the scripts:

스크립트 동작Script behavior

두 스크립트의 동작은 동일합니다.Both scripts have the same behavior. 스크립트는 CLI 빌드 저장 위치에서 ZIP/tarball 파일을 다운로드하여 기본 위치나 -InstallDir|--install-dir로 지정한 위치에 설치를 계속 진행합니다.They download the ZIP/tarball file from the CLI build drops and proceed to install it in either the default location or in a location specified by -InstallDir|--install-dir.

기본적으로 설치 스크립트는 SDK를 다운로드하고 설치합니다.By default, the installation scripts download the SDK and install it. 공유 런타임만 가져오려는 경우 -Runtime|--runtime 인수를 지정합니다.If you wish to only obtain the shared runtime, specify the -Runtime|--runtime argument.

기본적으로 스크립트는 현재 세션에 대한 $PATH에 설치 위치를 추가합니다.By default, the script adds the install location to the $PATH for the current session. -NoPath|--no-path 인수를 지정하여 이 기본 동작을 재정의합니다.Override this default behavior by specifying the -NoPath|--no-path argument. 스크립트는 DOTNET_ROOT 환경 변수를 설정하지 않습니다.The script doesn't set the DOTNET_ROOT environment variable.

스크립트를 실행하기 전에 필요한 모든 종속성을 설치하세요.Before running the script, install the required dependencies.

-Version|--version 인수를 사용하여 특정 버전을 설치할 수 있습니다.You can install a specific version using the -Version|--version argument. 버전은 2.1.0과 같이 세 부분으로 구성된 버전 번호로 지정해야 합니다.The version must be specified as a three-part version number, such as 2.1.0. 버전을 지정하지 않은 경우 스크립트는 latest 버전을 설치합니다.If the version isn't specified, the script installs the latest version.

설치 스크립트는 Windows에서 레지스트리를 업데이트하지 않습니다.The install scripts do not update the registry on Windows. 단지 압축된 이진 파일을 다운로드하여 폴더에 복사합니다.They just download the zipped binaries and copy them to a folder. 레지스트리 키 값을 업데이트하려면 .NET Core 설치 관리자를 사용합니다.If you want registry key values to be updated, use the .NET Core installers.

옵션Options

  • -Architecture|--architecture <ARCHITECTURE>

    설치할 .NET Core 바이너리의 아키텍처입니다.Architecture of the .NET Core binaries to install. 가능한 값은 <auto>, amd64, x64, x86, arm64arm입니다.Possible values are <auto>, amd64, x64, x86, arm64, and arm. 기본값은 현재 실행 중인 OS 아키텍처를 나타내는 <auto>입니다.The default value is <auto>, which represents the currently running OS architecture.

  • -AzureFeed|--azure-feed

    설치 관리자에 대한 Azure 피드의 URL을 지정합니다.Specifies the URL for the Azure feed to the installer. 이 값은 변경하지 않는 것이 좋습니다.We recommended that you don't change this value. 기본값은 https://dotnetcli.azureedge.net/dotnet입니다.The default value is https://dotnetcli.azureedge.net/dotnet.

  • -Channel|--channel <CHANNEL>

    설치에 대한 소스 채널을 지정합니다.Specifies the source channel for the installation. 가능한 값은 다음과 같습니다.The possible values are:

    • Current - 최신 릴리스입니다.Current - Most current release.
    • LTS - 장기 지원 채널(지원되는 최신 릴리스)입니다.LTS - Long-Term Support channel (most current supported release).
    • 특정 릴리스를 나타내는 X.Y 형식의 두 부분으로 된 버전입니다(예: 2.1 또는 3.0).Two-part version in X.Y format representing a specific release (for example, 2.1 or 3.0).
    • 예를 들어 분기 이름은 release/3.1.1xx 또는 master(야간 릴리스의 경우)입니다.Branch name: for example, release/3.1.1xx or master (for nightly releases). 미리 보기 채널에서 버전을 설치하려면 이 옵션을 사용합니다.Use this option to install a version from a preview channel. 설치 관리자 및 이진 파일에 나열된 채널 이름을 사용합니다.Use the name of the channel as listed in Installers and Binaries.

    기본값은 LTS입니다.The default value is LTS. .NET 지원 채널에 대한 자세한 내용은 .NET 지원 정책 페이지를 참조하세요.For more information on .NET support channels, see the .NET Support Policy page.

  • -DryRun|--dry-run

    설정하면 스크립트에서 설치를 수행하지는 않지만,If set, the script won't perform the installation. 대신 현재 요청된 버전의 .NET Core CLI를 일관되게 설치하기 위해 사용할 명령줄을 표시합니다.Instead, it displays what command line to use to consistently install the currently requested version of the .NET Core CLI. 예를 들어 latest 버전을 지정하면 빌드 스크립트에서 이 명령을 결정적으로 사용할 수 있도록 특정 버전에 대한 링크를 표시합니다.For example, if you specify version latest, it displays a link with the specific version so that this command can be used deterministically in a build script. 또한 직접 설치하거나 다운로드하는 것을 선호하는 경우 이진 파일 위치를 표시합니다.It also displays the binary's location if you prefer to install or download it yourself.

  • -FeedCredential|--feed-credential

    Azure 피드에 추가할 쿼리 문자열로 사용됩니다.Used as a query string to append to the Azure feed. public이 아닌 Blob 스토리지 계정을 사용하도록 URL을 변경할 수 있습니다.It allows changing the URL to use non-public blob storage accounts.

  • --help

    스크립트에 대한 도움말을 출력합니다.Prints out help for the script. Bash 스크립트에만 적용됩니다.Applies only to bash script. PowerShell의 경우 Get-Help ./dotnet-install.ps1을 사용합니다.For PowerShell, use Get-Help ./dotnet-install.ps1.

  • -InstallDir|--install-dir <DIRECTORY>

    설치 경로를 지정합니다.Specifies the installation path. 디렉터리가 없을 경우 만듭니다.The directory is created if it doesn't exist. 기본값은 %LocalAppData%\Microsoft\dotnet(Windows) 또는 /usr/share/dotnet(Linux/macOS)입니다.The default value is %LocalAppData%\Microsoft\dotnet on Windows and /usr/share/dotnet on Linux/macOS. 이진 파일은 이 디렉터리에 바로 배치됩니다.Binaries are placed directly in this directory.

  • -JSonFile|--jsonfile <JSONFILE>

    SDK 버전을 확인하는 데 사용되는 global.json 파일의 경로를 지정합니다.Specifies a path to a global.json file that will be used to determine the SDK version. global.json 파일에 sdk:version의 값이 있어야 합니다.The global.json file must have a value for sdk:version.

  • -NoCdn|--no-cdn

    Azure CDN(Content Delivery Network)에서 다운로드할 수 없도록 설정하고 캐시되지 않은 피드를 바로 사용합니다.Disables downloading from the Azure Content Delivery Network (CDN) and uses the uncached feed directly.

  • -NoPath|--no-path

    설정하면 설치 폴더를 현재 세션의 경로로 내보내지 않습니다.If set, the installation folder isn't exported to the path for the current session. 기본적으로 스크립트는 경로를 수정하므로 설치 후 .NET Core CLI를 즉시 사용할 수 있습니다.By default, the script modifies the PATH, which makes the .NET Core CLI available immediately after install.

  • -ProxyAddress

    설정된 경우 설치 관리자에서 웹 요청을 만들 때 프록시를 사용합니다.If set, the installer uses the proxy when making web requests. (Windows에만 유효함)(Only valid for Windows.)

  • -ProxyBypassList <LIST_OF_URLS>

    ProxyAddress를 사용하여 설정하는 경우 프록시를 우회하는 쉼표로 구분된 URL 목록을 제공합니다.If set with ProxyAddress, provides a list of comma-separated urls that will bypass the proxy. (Windows에만 유효함)(Only valid for Windows.)

  • ProxyUseDefaultCredentials

    설정하면 설치 관리자가 프록시 주소를 사용할 때 현재 사용자의 자격 증명을 사용합니다.If set, the installer uses the credentials of the current user when using proxy address. (Windows에만 유효함)(Only valid for Windows.)

  • -Runtime|--runtime <RUNTIME>

    전체 SDK가 아닌 공유 런타임만 설치합니다.Installs just the shared runtime, not the entire SDK. 가능한 값은 다음과 같습니다.The possible values are:

    • dotnet - Microsoft.NETCore.App 공유 런타임입니다.dotnet - the Microsoft.NETCore.App shared runtime.
    • aspnetcore - Microsoft.AspNetCore.App 공유 런타임입니다.aspnetcore - the Microsoft.AspNetCore.App shared runtime.
    • windowsdesktop - Microsoft.WindowsDesktop.App 공유 런타임입니다.windowsdesktop - the Microsoft.WindowsDesktop.App shared runtime.
  • --runtime-id <RID>

    도구가 설치되는 런타임 식별자를 지정합니다.Specifies the runtime identifier for which the tools are being installed. 휴대용 Linux에 linux-x64를 사용합니다.Use linux-x64 for portable Linux. (Linux/macOS에만 유효함)(Only valid for Linux/macOS.)

  • -SharedRuntime|--shared-runtime

    참고

    이 매개 변수는 더 이상 사용되지 않으며 스크립트의 이후 버전에서 제거될 수 있습니다.This parameter is obsolete and may be removed in a future version of the script. 대신 -Runtime|--runtime 옵션을 사용하는 것이 좋습니다.The recommended alternative is the -Runtime|--runtime option.

    전체 SDK가 아니라 공유 런타임 비트만 설치합니다.Installs just the shared runtime bits, not the entire SDK. 이 옵션은 -Runtime|--runtime dotnet을 지정하는 것과 같습니다.This option is equivalent to specifying -Runtime|--runtime dotnet.

  • -SkipNonVersionedFiles|--skip-non-versioned-files

    dotnet.exe와 같은 버전이 없는 파일이 있을 경우 해당 파일의 설치를 건너뜁니다.Skips installing non-versioned files, such as dotnet.exe, if they already exist.

  • -UncachedFeed|--uncached-feed

    이 설치 관리자가 사용하는 캐시되지 않은 피드의 URL을 변경할 수 있습니다.Allows changing the URL for the uncached feed used by this installer. 이 값은 변경하지 않는 것이 좋습니다.We recommended that you don't change this value.

  • -Verbose|--verbose

    진단 정보를 표시합니다.Displays diagnostics information.

  • -Version|--version <VERSION>

    특정 빌드 버전을 나타냅니다.Represents a specific build version. 가능한 값은 다음과 같습니다.The possible values are:

    • latest - 채널의 최신 빌드입니다(-Channel 옵션과 함께 사용됨).latest - Latest build on the channel (used with the -Channel option).
    • 특정 빌드 버전을 나타내는 X.Y.Z 형식의 세 부분으로 구성된 버전이며 -Channel 옵션을 대체합니다.Three-part version in X.Y.Z format representing a specific build version; supersedes the -Channel option. 예를 들어 2.0.0-preview2-006120을 참조하십시오.For example: 2.0.0-preview2-006120.

    지정하지 않으면 -Version은 기본값인 latest로 설정됩니다.If not specified, -Version defaults to latest.

Examples

  • 기본 위치에 최신 LTS(장기 지원) 버전을 설치합니다.Install the latest long-term supported (LTS) version to the default location:

    Windows:Windows:

    ./dotnet-install.ps1 -Channel LTS
    

    macOS/Linux:macOS/Linux:

    ./dotnet-install.sh --channel LTS
    
  • 3.1 채널에서 지정된 위치에 최신 버전을 설치합니다.Install the latest version from 3.1 channel to the specified location:

    Windows:Windows:

    ./dotnet-install.ps1 -Channel 3.1 -InstallDir C:\cli
    

    macOS/Linux:macOS/Linux:

    ./dotnet-install.sh --channel 3.1 --install-dir ~/cli
    
  • 3.0.0 버전의 공유 런타임을 설치합니다.Install the 3.0.0 version of the shared runtime:

    Windows:Windows:

    ./dotnet-install.ps1 -Runtime dotnet -Version 3.0.0
    

    macOS/Linux:macOS/Linux:

    ./dotnet-install.sh --runtime dotnet --version 3.0.0
    
  • 스크립트를 얻어 회사 프록시 뒤에 2.1.2 버전을 설치합니다(Windows에만 해당).Obtain script and install the 2.1.2 version behind a corporate proxy (Windows only):

    Invoke-WebRequest 'https://dot.net/v1/dotnet-install.ps1' -Proxy $env:HTTP_PROXY -ProxyUseDefaultCredentials -OutFile 'dotnet-install.ps1';
    ./dotnet-install.ps1 -InstallDir '~/.dotnet' -Version '2.1.2' -ProxyAddress $env:HTTP_PROXY -ProxyUseDefaultCredentials;
    
  • 스크립트 가져와서 .NET Core CLI one-liner 예제를 설치합니다.Obtain script and install .NET Core CLI one-liner examples:

    Windows:Windows:

    # Run a separate PowerShell process because the script calls exit, so it will end the current PowerShell session.
    &powershell -NoProfile -ExecutionPolicy unrestricted -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; &([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing 'https://dot.net/v1/dotnet-install.ps1'))) <additional install-script args>"
    

    macOS/Linux:macOS/Linux:

    curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin <additional install-script args>
    

참조See also