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

nameName

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

개요Synopsis

Windows:Windows:

dotnet-install.ps1 [-Channel] [-Version] [-InstallDir] [-Architecture] [-SharedRuntime] [-Runtime] [-DryRun] [-NoPath] [-Verbose] [-AzureFeed] [-UncachedFeed] [-NoCdn] [-FeedCredential] [-ProxyAddress] [-ProxyUseDefaultCredentials] [-SkipNonVersionedFiles] [-Help]

macOS/Linux:macOS/Linux:

dotnet-install.sh [--channel] [--version] [--install-dir] [--architecture] [--runtime] [--dry-run] [--no-path] [--verbose] [--azure-feed] [--uncached-feed] [--no-cdn] [--feed-credential] [--runtime-id] [--skip-non-versioned-files] [--help]

설명Description

dotnet-install 스크립트는 .NET Core CLI 도구 및 공유 런타임을 포함하는 .NET Core SDK의 비관리자 설치를 수행하는 데 사용됩니다.The dotnet-install scripts are used to perform a non-admin installation of the .NET Core SDK, which includes the .NET Core CLI tools and the shared runtime.

.NET Core 기본 웹 사이트에서 호스팅되는 안정적인 버전을 사용하는 것이 좋습니다.We recommend that you use the stable version that is hosted on .NET Core main website. 스크립트에 대한 직접 경로는 다음과 같습니다.The direct paths to the scripts are:

이러한 스크립트의 주요 유용성은 자동화 시나리오 및 비관리자 설치입니다.The main usefulness of these scripts is in automation scenarios and non-admin installations. 두 개의 스크립트가 있습니다. 하나는 Windows에서 작동하는 PowerShell 스크립트이고, 다른 하나는 Linux/macOS에서 작동하는 bash 스크립트입니다.There are two scripts: one is a PowerShell script that works on Windows, and the other is a bash script that works on Linux/macOS. 두 스크립트의 동작은 동일합니다.Both scripts have the same behavior. 또한 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.

설치 스크립트는 CLI 빌드 저장 위치에서 ZIP/tarball 파일을 다운로드하여 기본 위치나 -InstallDir|--install-dir로 지정한 위치에 설치를 계속 진행합니다.The installation scripts 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 인수를 지정합니다.If you wish to only obtain the shared runtime, specify the --runtime argument.

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

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

--version 인수를 사용하여 특정 버전을 설치할 수 있습니다.You can install a specific version using the --version argument. 버전은 세 부분으로 구성된 버전(예: 1.0.0-13232)으로 지정해야 합니다.The version must be specified as a three-part version (for example, 1.0.0-13232). 제공하지 않으면 latest 버전을 사용합니다.If not provided, it uses the latest version.

옵션Options

  • -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.0 또는 1.0).Two-part version in X.Y format representing a specific release (for example, 2.0 or 1.0).
    • 분기 이름입니다.Branch name. 예를 들어 release/2.0.0, release/2.0.0-preview2 또는 master(야간 릴리스의 경우)입니다.For example, release/2.0.0, release/2.0.0-preview2, or master (for nightly releases).

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

  • -Version <VERSION>

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

    • latest - 채널의 최신 빌드입니다(-Channel 옵션과 함께 사용됨).latest - Latest build on the channel (used with the -Channel option).
    • coherent - 채널의 일관된 최신 빌드로, 안정적인 최신 패키지 조합을 사용합니다(분기 이름 -Channel 옵션과 함께 사용됨).coherent - Latest coherent build on the channel; uses the latest stable package combination (used with Branch name -Channel options).
    • 특정 빌드 버전을 나타내는 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-006120For example: 2.0.0-preview2-006120.

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

  • -InstallDir <DIRECTORY>

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

  • -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.

  • -SharedRuntime

    참고

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

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

  • -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.
  • -DryRun

    설정하면 스크립트에서 설치를 수행하지는 않지만,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.

  • -NoPath

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

  • -Verbose

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

  • -AzureFeed

    설치 관리자에 대한 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.

  • -UncachedFeed

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

  • -NoCdn

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

  • -FeedCredential

    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.

  • -ProxyAddress

    설정된 경우 설치 관리자에서 웹 요청을 만들 때 프록시를 사용합니다.If set, the installer uses the proxy when making web requests. (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)

  • -SkipNonVersionedFiles

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

  • -Help

    스크립트에 대한 도움말을 출력합니다.Prints out help for the script.

예제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
    
  • 지정된 위치에 2.0 채널의 최신 버전을 설치합니다.Install the latest version from 2.0 channel to the specified location:

    Windows:Windows:

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

    macOS/Linux:macOS/Linux:

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

    Windows:Windows:

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

    macOS/Linux:macOS/Linux:

    ./dotnet-install.sh --runtime dotnet --version 1.1.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:

    @powershell -NoProfile -ExecutionPolicy unrestricted -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; &([scriptblock]::Create((Invoke-WebRequest -useb '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