dotnet tool install

Ten artykuł dotyczy: ✔️ .NET Core 3.1 SDK i nowsze wersje

Nazwa

dotnet tool install — Instaluje określone narzędzie .NET na maszynie.

Streszczenie

dotnet tool install <PACKAGE_NAME> -g|--global
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Opis

Polecenie dotnet tool install umożliwia zainstalowanie narzędzi platformy .NET na maszynie. Aby użyć polecenia , należy określić jedną z następujących opcji instalacji:

  • Aby zainstalować narzędzie globalne w domyślnej lokalizacji, użyj --global opcji .
  • Aby zainstalować narzędzie globalne w lokalizacji niestandardowej, użyj --tool-path opcji .
  • Aby zainstalować narzędzie lokalne, pomiń opcje --global i --tool-path .

Narzędzia globalne są instalowane w następujących katalogach domyślnie po określeniu -g opcji lub --global :

System operacyjny Ścieżka
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Narzędzia lokalne są dodawane do pliku dotnet-tools.json w katalogu .config w bieżącym katalogu. Jeśli plik manifestu jeszcze nie istnieje, utwórz go, uruchamiając następujące polecenie:

dotnet new tool-manifest

Aby uzyskać więcej informacji, zobacz Instalowanie narzędzia lokalnego.

Argumenty

  • PACKAGE_NAME

    Nazwa/identyfikator pakietu NuGet zawierającego narzędzie .NET do zainstalowania.

Opcje

  • --add-source <SOURCE>

    Dodaje dodatkowe źródło pakietu NuGet do użycia podczas instalacji. Kanały informacyjne są dostępne równolegle, a nie sekwencyjnie w pewnej kolejności pierwszeństwa. Jeśli ten sam pakiet i wersja są w wielu kanałach informacyjnych, najszybsze źródło danych wygrywa. Aby uzyskać więcej informacji, zobacz Co się stanie po zainstalowaniu pakietu NuGet?.

  • --configfile <FILE>

    Plik konfiguracji NuGet (nuget.config) do użycia. Jeśli zostanie określony, zostaną użyte tylko ustawienia z tego pliku. Jeśli nie zostanie określony, zostanie użyta hierarchia plików konfiguracji z bieżącego katalogu. Aby uzyskać więcej informacji, zobacz Typowe konfiguracje NuGet.

  • --disable-parallel

    Zapobiegaj przywracaniu wielu projektów równolegle.

  • --framework <FRAMEWORK>

    Określa platformę docelową do zainstalowania narzędzia. Domyślnie zestaw .NET SDK próbuje wybrać najbardziej odpowiednią platformę docelową.

  • -g|--global

    Określa, że instalacja jest szeroka dla użytkownika. Nie można połączyć z opcją --tool-path . Pomijając zarówno --global instalację narzędzia lokalnego, jak i --tool-path określa.

  • -?|-h|--help

    Wyświetla opis sposobu używania polecenia .

  • --ignore-failed-sources

    Traktuj błędy źródła pakietu jako ostrzeżenia.

  • --interactive

    Umożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania.

  • --local

    Zaktualizuj narzędzie i manifest narzędzia lokalnego. Nie można połączyć z opcją --global lub opcją --tool-path .

  • --no-cache

    Nie buforuj pakietów i żądań HTTP.

  • --tool-manifest <PATH>

    Ścieżka do pliku manifestu.

  • --tool-path <PATH>

    Określa lokalizację, w której ma zostać zainstalowane narzędzie globalne. ŚCIEŻKA może być bezwzględna lub względna. Jeśli ścieżka nie istnieje, polecenie próbuje go utworzyć. Pomijając zarówno --global instalację narzędzia lokalnego, jak i --tool-path określa.

  • -v|--verbosity <LEVEL>

    Ustawia poziom szczegółowości polecenia. Dozwolone wartości to q[uiet], , n[ormal]m[inimal], d[etailed]i diag[nostic]. Aby uzyskać więcej informacji, zobacz LoggerVerbosity.

  • --version <VERSION_NUMBER>

    Wersja narzędzia do zainstalowania. Domyślnie jest zainstalowana najnowsza stabilna wersja pakietu. Użyj tej opcji, aby zainstalować wersję zapoznawcza lub starsze wersje narzędzia.

Przykłady

  • dotnet tool install -g dotnetsay

    Instaluje narzędzie dotnetsay jako narzędzie globalne w lokalizacji domyślnej.

  • dotnet tool install dotnetsay --tool-path c:\global-tools

    Instaluje narzędzie dotnetsay jako narzędzie globalne w określonym katalogu Windows.

  • dotnet tool install dotnetsay --tool-path ~/bin

    Instaluje narzędzie dotnetsay jako narzędzie globalne w określonym katalogu systemu Linux/macOS.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Instaluje wersję 2.0.0 dotnetsay jako narzędzie globalne.

  • dotnet tool install dotnetsay

    Instaluje narzędzie dotnetsay jako narzędzie lokalne dla bieżącego katalogu.

Zobacz też