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

W systemie 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]

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, a drugi to skrypt powłoki bash, który działa w systemie 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. 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ć --runtime argumentu.If you wish to only obtain the shared runtime, specify the --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 (na przykład 1.0.0-13232) w wersji trzyczęściowej serii.The version must be specified as a three-part version (for example, 1.0.0-13232). Jeśli nie zostanie podana, używa latest wersji.If not provided, 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 — Najnowsza wersja.Current - Most current release.
    • LTS — Długoterminowe kanału pomocy technicznej (Najnowsza wersja obsługiwane).LTS - Long-Term Support channel (most 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.Branch name. Na przykład release/2.0.0, release/2.0.0-preview2, lub master (w przypadku nocne wydania).For example, release/2.0.0, release/2.0.0-preview2, or master (for 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 obsługuje zasady strony.For more information on .NET support channels, see the .NET Support Policy page.

  • -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 opcji).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-006120.For example: 2.0.0-preview2-006120.

    Jeśli nie zostanie określony, -Version wartość domyślna to latest.If not specified, -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%\Microsoft\dotnet.The default value is %LocalAppData%\Microsoft\dotnet. Pliki binarne są umieszczane bezpośrednio w tym katalogu.Binaries are placed directly in this 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>, amd64, x64, x86, arm64, i arm.Possible values are <auto>, amd64, x64, x86, arm64, and arm. 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

    Uwaga

    Ten parametr jest przestarzały i może zostać usunięty w przyszłych wersjach skryptu.This parameter is obsolete and may be removed in a future version of the script. Zalecaną alternatywą jest Runtime opcji.The recommended alternative is the Runtime option.

    Instaluje tylko bity udostępnionego środowiska uruchomieniowego, a nie całego zestawu SDK.Installs just the shared runtime bits, not the entire SDK. To jest równoznaczne z użyciem -Runtime dotnet.This is equivalent to specifying -Runtime dotnet.

  • -Runtime <RUNTIME>

    Instaluje tylko udostępnionego środowiska uruchomieniowego, nie cały zestaw SDK.Installs just the shared runtime, not the entire SDK. Możliwe wartości to:The possible values are:

    • dotnet - Microsoft.NETCore.App udostępnionego środowiska uruchomieniowego.dotnet - the Microsoft.NETCore.App shared runtime.
    • aspnetcore - Microsoft.AspNetCore.App udostępnionego środowiska uruchomieniowego.aspnetcore - the Microsoft.AspNetCore.App shared runtime.
  • -DryRun

    Jeśli nie będzie ustawiona, skrypt przeprowadzić instalację.If set, the script won't perform the installation. Zamiast tego wyświetla wiersz polecenia na potrzeby spójnego zainstalować obecnie żądana wersja interfejsu wiersza polecenia platformy .NET Core.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ślona wersja 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 zestawu i folderu instalacji nie jest eksportowany do ścieżki dla bieżącej sesji.If set, the installation folder isn't exported to the path for the current session. Domyślnie skrypt modyfikuje ścieżki, która udostępnia natychmiast po przeprowadzeniu instalacji narzędzi interfejsu wiersza polecenia.By default, the script modifies the PATH, which makes the CLI tools available immediately after install.

  • -Verbose

    Wyświetla informacje diagnostyczne.Displays diagnostics information.

  • -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. Zaleca się, że nie możesz zmienić tę wartość.We recommended that you don't change this value. Wartość domyślna to https://dotnetcli.azureedge.net/dotnet.The default value is https://dotnetcli.azureedge.net/dotnet.

  • -UncachedFeed

    Umożliwia, zmiana adresu URL dla źródła danych bez buforowania używane przez tego Instalatora.Allows changing the URL for the uncached feed used by this installer. Zaleca się, że nie możesz zmienić tę wartość.We recommended that you don't change this value.

  • -NoCdn

    Wyłącza pobierania z Azure Content Delivery Network (CDN) i korzysta z bezpośrednio bez buforowania źródła danych.Disables downloading from the Azure Content Delivery Network (CDN) and uses the uncached feed directly.

  • -FeedCredential

    Używane jako ciąg zapytania do dołączenia do platformy Azure, źródła danych.Used as a query string to append to the Azure feed. Umożliwia ona, zmiana adresu URL, aby użyć konta magazynu obiektów blob bez publicznego.It allows changing the URL to use non-public blob storage accounts.

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

  • ProxyUseDefaultCredentials

    Jeśli zestaw, Instalator używa poświadczeń bieżącego użytkownika, korzystając z adresu serwera proxy.If set, the installer uses the credentials of the current user when using proxy address. (Ta funkcja jest prawidłowa tylko dla Windows)(Only valid for Windows)

  • -SkipNonVersionedFiles

    Pomija instalowania innych wersji plików, takich jak dotnet.exe, jeśli już istnieje.Skips installing non-versioned files, such as dotnet.exe, if they already exist.

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

    W systemie Windows:Windows:

    ./dotnet-install.ps1 -Channel LTS
    

    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:

    W systemie Windows:Windows:

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

    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:

    W systemie Windows:Windows:

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

    macOS/Linux:macOS/Linux:

    ./dotnet-install.sh --runtime dotnet --version 1.1.0
    
  • Skrypt należy uzyskać i zainstalować 2.1.2 wersja za firmowym serwerem proxy (tylko 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;
    
  • Uzyskać skrypt i zainstaluj interfejs wiersza polecenia platformy .NET Core one-liner przykłady:Obtain script and install .NET Core CLI one-liner examples:

    W systemie 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>
    

Zobacz takżeSee also