Справка по скриптам dotnet-installdotnet-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]

Mac OS и 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 используются для установки пакета SDK для .NET Core без прав администратора. Этот пакет включает общую среду выполнения и средства .NET Core CLI.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. Имеются два скрипта: один для PowerShell (работает в Windows), а второй — bash-скрипт, который работает в Linux и macOS.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.The bash script also reads PowerShell switches, so you can use PowerShell switches with the script on Linux/macOS systems.

Скрипты установки скачивают файл ZIP или TAR из места сборки CLI, а затем осуществляют установку в расположении по умолчанию или расположении, заданном параметром -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-006120.For 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, arm64 и arm.Possible values are <auto>, amd64, x64, x86, arm64, and arm. Значение по умолчанию — <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. По умолчанию скрипт изменит значение PATH, благодаря этому средства CLI становятся доступными сразу после установки.By default, the script modifies the PATH, which makes the CLI tools available immediately after install.

  • -Verbose

    Отображает сведения о диагностике.Displays diagnostics information.

  • -AzureFeed

    Указывает URL-адрес для веб-канала Azure этого установщика.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

    Отключает загрузку из сети доставки содержимого Microsoft Azure (CDN) и напрямую использует некэшированный веб-канал.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. Позволяет изменять URL-адрес для использования учетных записей хранилища BLOB-объектов, не являющихся общедоступными.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
    

    Mac OS и 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
    

    Mac OS и 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
    

    Mac OS и 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: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>"
    

    Mac OS и Linux:macOS/Linux:

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

См. такжеSee also