Dokumentacja skryptów instalacji DotNetdotnet-install scripts reference

NazwaName

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

StreszczenieSynopsis

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 przeprowadzenia instalacji bez uprawnień administratora programu .NET Core SDK, w tym narzędzi interfejsu wiersza polecenia platformy .NET Core i udostępnionego środowiska uruchomieniowego.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 jest hostowana na głównej witryny internetowej platformy .NET Core.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:

Główne użyteczność tych skryptów znajduje się w scenariuszach automatyzacji oraz przed instalacjami bez uprawnień administratora.The main usefulness of these scripts is in automation scenarios and non-admin installations. Istnieją dwa skrypty: jeden z nich jest skrypt programu PowerShell, który działa na Windows.There are two scripts: One is a PowerShell script that works on Windows. Skrypt programu jest skrypt powłoki bash, który działa w systemie Linux/macOS.The other script is a bash script that works on Linux/macOS. Zarówno skryptów mają takie samo zachowanie.Both scripts have the same behavior. Skrypt powłoki bash odczytuje również przełączników programu PowerShell, aby można było 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 instalacji Pobierz plik ZIP/pliku tar z spadnie 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 uzyskać tylko udostępnionego środowiska uruchomieniowego, należy określić --shared-runtime argumentu.If you wish to only obtain the shared runtime, specify the --shared-runtime argument.

Domyślnie skrypt ten dodaje lokalizacji instalacji do $PATH dla bieżącej sesji.By default, the script adds the install location to the $PATH for the current session. To zachowanie domyślne można przesłonić, 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 to zrobić przy użyciu określonej wersji --version argumentu.You can install a specific version using the --version argument. Wersja muszą być określone jako część 3 wersji (na przykład 1.0.0-13232).The version must be specified as a 3-part version (for example, 1.0.0-13232). Jeśli argument jest pominięty, zostanie użyta latest wersji.If omitted, it uses the latest version.

OpcjeOptions

-Channel <CHANNEL>

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

  • Current -Bieżąca wersjaCurrent - Current release
  • LTS — Długoterminowe kanału pomocy technicznej (bieżąca wersja obsługiwane)LTS - Long-Term Support channel (current supported release)
  • Wersja legalną dwuczęściową w formacie X.Y reprezentujący 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 uzyskać najnowsze informacje przedstawią master gałęzi ("jest edge" nocne wydania)]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 wersję konkretnej 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 — Najnowsza wersja spójnego kompilacji na kanał. używa kombinacji najnowszy stabilny pakiet (używany przy użyciu gałęzi o nazwie -Channel opcje)coherent - Latest coherent build on the channel; uses the latest stable package combination (used with Branch name -Channel options)
  • Trzyczęściowej wersję w formacie X.Y.Z reprezentującą określony 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

W przypadku pominięcia -Version wartość domyślna to 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 platformy .NET Core pliki binarne 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, który reprezentuje aktualnie uruchomionych architektury systemu operacyjnego.The default value is auto, which represents the currently running OS architecture.

-SharedRuntime

Jeśli ustawiona, ten przełącznik ogranicza instalacji udostępnionego środowiska uruchomieniowego.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 wiersz polecenia na potrzeby spójnego zainstalować obecnie żądana wersja interfejsu wiersza polecenia platformy .NET Core.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 w przypadku określenia wersji latest, wyświetla łącze do określonej wersji, aby to polecenie może być używane w sposób deterministyczny 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. Lokalizacja tego pliku binarnego również wyświetlana, jeśli wolisz zainstalować lub pobrać go samodzielnie.It also displays the binary's location if you prefer to install or download it yourself.

-NoPath

Jeśli ustawiona, prefiks/installdir nie są eksportowane 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 zostanie zmodyfikowany ś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 do 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 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

W domyślnej lokalizacji, należy zainstalować najnowsze długoterminowe obsługiwaną wersję (LTS):Install the latest long-term supported (LTS) version to the default location:

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:

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 udostępnionego środowiska uruchomieniowego:Install the 1.1.0 version of the shared runtime:

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 interfejs wiersza polecenia platformy .NET Core one-liner przykłady: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>"

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