odwołania skryptów instalacji DotNetdotnet-install scripts reference

NazwaName

dotnet-install.ps1 | dotnet-install.sh -Skrypt użyty do zainstalowania narzędzi interfejsu wiersza polecenia platformy .NET Core i udostępnionych środowiska uruchomieniowego.dotnet-install.ps1 | dotnet-install.sh - Script used to install the .NET Core CLI tools and the shared runtime.

StreszczenieSynopsis

System Windows:Windows:

dotnet-install.ps1 [-Channel] [-Version] [-InstallDir] [-Architecture] [-SharedRuntime] [-DryRun] [-NoPath] [-AzureFeed] [-ProxyAddress] [--Verbose] [--Help]

System macOS/Linux:macOS/Linux:

dotnet-install.sh [--channel] [--version] [--install-dir] [--architecture] [--shared-runtime] [--dry-run] [--no-path] [--azure-feed] [--verbose] [--help]

OpisDescription

dotnet-install Skrypty są używane do wykonywania instalacji programu .NET Core SDK, w tym narzędzi interfejsu wiersza polecenia platformy .NET Core i udostępnionych środowiska wykonawczego o bez uprawnień administratora.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.

Zalecane jest użycie stabilną wersję, która znajduje się na .NET Core głównym witryny sieci Web.We recommend that you use the stable version that is hosted on .NET Core main website. Bezpośrednie ścieżki do skryptów są:The direct paths to the scripts are:

Jest głównym przydatność te skrypty w scenariuszach automatyzacji i instalacji bez uprawnień administratora.The main usefulness of these scripts is in automation scenarios and non-admin installations. Istnieją dwa skrypty: jedna jest skrypt programu PowerShell, która działa w systemie Windows.There are two scripts: One is a PowerShell script that works on Windows. Inne skryptu to skrypt bash, który działa na systemie Linux/macOS.The other script is a bash script that works on Linux/macOS. Zarówno skryptów ma takie samo zachowanie.Both scripts have the same behavior. Skrypt bash odczytuje również przełączników programu PowerShell, dzięki czemu można używać przełączników programu PowerShell przy użyciu skryptu w systemach Linux/macOS.The bash script also reads PowerShell switches, so you can use PowerShell switches with the script on Linux/macOS systems.

Skrypty instalacyjne Pobierz plik ZIP/tarball z porzucania kompilacji interfejsu wiersza polecenia i przejdź do instalacji w lokalizacji domyślnej lub w lokalizacji określonej przez -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. Domyślnie skrypty instalacyjne Pobierz zestaw SDK i zainstaluj go.By default, the installation scripts download the SDK and install it. Jeśli chcesz tylko uzyskać udostępnionego środowiska uruchomieniowego, określ --shared-runtime argumentu.If you wish to only obtain the shared runtime, specify the --shared-runtime argument.

Domyślnie skrypt dodaje lokalizacji instalacji do $PATH dla bieżącej sesji.By default, the script adds the install location to the $PATH for the current session. Zmienić to zachowanie domyślne, określając --no-path argumentu.Override this default behavior by specifying the --no-path argument.

Przed uruchomieniem skryptu, zainstalować wymagane zależności.Before running the script, install the required dependencies.

Można zainstalować przy użyciu określonej wersji --version argumentu.You can install a specific version using the --version argument. Należy określić wersję w wersji 3 części (na przykład 1.0.0-13232).The version must be specified as a 3-part version (for example, 1.0.0-13232). Pominięcie używa latest wersji.If omitted, it uses the latest version.

OpcjeOptions

-Channel <CHANNEL>

Określa kanał źródła instalacji.Specifies the source channel for the installation. Możliwe wartości to:The possible values are:

  • Current -Bieżącej wersjiCurrent - Current release
  • LTS -Długoterminowej kanału pomocy technicznej (bieżąca wersja obsługiwane)LTS - Long-Term Support channel (current supported release)
  • Wersja dwóch elementów w formacie X.Y reprezentujący dla określonej wersji (na przykład 2.0 lub 1.0)Two-part version in X.Y format representing a specific release (for example, 2.0 or 1.0)
  • Nazwa gałęzi [na przykład release/2.0.0, release/2.0.0-preview2, lub master najnowsze z master gałęzi (wydań co noc "marginesy krawędzi")]Branch name [for example, release/2.0.0, release/2.0.0-preview2, or master for the latest from the master branch ("bleeding edge" nightly releases)]

Wartość domyślna to LTS.The default value is LTS. Aby uzyskać więcej informacji dotyczących kanałów pomocy technicznej platformy .NET, zobacz .NET Core Cykl wsparcia technicznego produktów tematu.For more information on .NET support channels, see the .NET Core Support Lifecycle topic.

-Version <VERSION>

Reprezentuje wersji określonej kompilacji.Represents a specific build version. Możliwe wartości to:The possible values are:

  • latest -Najnowszych kompilacji w kanale (używany z -Channel opcja)latest - Latest build on the channel (used with the -Channel option)
  • coherent -Najnowszych spójnego kompilacji na kanał. używa kombinacji najnowsza stabilna pakietu (używana z nazwą gałęzi -Channel opcje)coherent - Latest coherent build on the channel; uses the latest stable package combination (used with Branch name -Channel options)
  • Trzech części wersja reprezentujący określony format X.Y.Z kompilacji wersji; zastępuje -Channel opcji.Three-part version in X.Y.Z format representing a specific build version; supersedes the -Channel option. Na przykład: 2.0.0-preview2-006120For example: 2.0.0-preview2-006120

Pominięcie -Version domyślnie latest.If omitted, -Version defaults to latest.

-InstallDir <DIRECTORY>

Określa ścieżkę instalacji.Specifies the installation path. Katalog jest tworzony, jeśli nie istnieje.The directory is created if it doesn't exist. Wartość domyślna to LocalAppData %.dotnet.The default value is %LocalAppData%.dotnet. Należy pamiętać, że pliki binarne są umieszczane bezpośrednio w katalogu.Note that binaries are placed directly in the directory.

-Architecture <ARCHITECTURE>

Architektura .NET Core plików binarnych do zainstalowania.Architecture of the .NET Core binaries to install. Możliwe wartości to auto, x64, i x86.Possible values are auto, x64, and x86. Wartość domyślna to auto, reprezentuje aktualnie uruchomionych architektury systemu operacyjnego.The default value is auto, which represents the currently running OS architecture.

-SharedRuntime

Jeśli ustawiona, tego przełącznika na instalację do udostępnionego środowiska wykonawczego.If set, this switch limits installation to the shared runtime. Cały zestaw SDK nie jest zainstalowany.The entire SDK isn't installed.

-DryRun

Jeśli nie będzie ustawiona, skrypt przeprowadzenia instalacji; ale zamiast tego Wyświetla jakie wiersza poleceń do używania w celu zainstalowania spójnie obecnie żądanej wersji programu .NET Core interfejsu wiersza polecenia.If set, the script won't perform the installation; but instead, it displays what command line to use to consistently install the currently requested version of the .NET Core CLI. Na przykład jeśli określisz wersji latest, zawiera łącze do określonej wersji, aby to polecenie może być używane w sposób niejednoznaczny w skrypcie kompilacji.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. Wyświetla również lokalizacji pliku binarnego, aby zainstalować lub pobrać samodzielnie.It also displays the binary's location if you prefer to install or download it yourself.

-NoPath

Jeśli ustawiona, prefiks/installdir nie zostaną wyeksportowane do ścieżki dla bieżącej sesji.If set, the prefix/installdir are not exported to the path for the current session. Domyślnie skrypt zmodyfikuje ścieżki, która udostępnia natychmiast po przeprowadzeniu instalacji narzędzi interfejsu wiersza polecenia.By default, the script will modify the PATH, which makes the CLI tools available immediately after install.

-AzureFeed

Określa, że adres URL dla platformy Azure źródła danych Instalatora.Specifies the URL for the Azure feed to the installer. Nie jest zalecane, aby zmienić tę wartość.It isn't recommended that you change this value. Wartość domyślna to https://dotnetcli.azureedge.net/dotnet.The default is https://dotnetcli.azureedge.net/dotnet.

-ProxyAddress

Jeśli zestaw, Instalator używa serwera proxy w przypadku wysyłania żądań sieci web.If set, the installer uses the proxy when making web requests. (Ta funkcja jest prawidłowa tylko dla systemu Windows)(Only valid for Windows)

--verbose

Wyświetlanie informacji diagnostycznych.Display diagnostics information.

--help

Drukuje pomoc dotyczącą skryptu.Prints out help for the script.

PrzykładyExamples

Zainstaluj najnowsze długoterminowej obsługiwaną wersję (LTS) w domyślnej lokalizacji:Install the latest long-term supported (LTS) version to the default location:

System Windows:Windows:

./dotnet-install.ps1 -Channel LTS

System macOS/Linux:macOS/Linux:

./dotnet-install.sh --channel LTS

Zainstaluj najnowszą wersję z kanału 2.0 do określonej lokalizacji:Install the latest version from 2.0 channel to the specified location:

System Windows:Windows:

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

System macOS/Linux:macOS/Linux:

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

Zainstaluj 1.1.0 wersji środowiska uruchomieniowego udostępnionego:Install the 1.1.0 version of the shared runtime:

System Windows:Windows:

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

System macOS/Linux:macOS/Linux:

./dotnet-install.sh --shared-runtime --version 1.1.0

Uzyskać skrypt i zainstaluj przykłady one-liner .NET Core interfejsu wiersza polecenia:Obtain script and install .NET Core CLI one-liner examples:

System Windows:Windows:

@powershell -NoProfile -ExecutionPolicy unrestricted -Command "&([scriptblock]::Create((Invoke-WebRequest -useb 'https://dot.net/v1/dotnet-install.ps1'))) <additional install-script args>"

System macOS/Linux:macOS/Linux:

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

Zobacz takżeSee also

Zwalnia .NET core .NET Core releases
Środowisko uruchomieniowe platformy .NET core i zestawu SDK Pobierz archiwum.NET Core Runtime and SDK download archive