dotnet tool install

Bu makale için geçerlidir: ✔️ .NET Core 2.1 SDK ve sonraki sürümleri

Name

dotnet tool install - Makinenize belirtilen .NET aracını yükleme.

Özet

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

Description

komutu, dotnet tool install makinenize .NET araçları yüklemeniz için bir yol sağlar. komutunu kullanmak için aşağıdaki yükleme seçeneklerine birini belirtin:

  • Varsayılan konuma genel bir araç yüklemek için seçeneğini --global kullanın.
  • Genel bir aracı özel bir konuma yüklemek için seçeneğini --tool-path kullanın.
  • Yerel bir araç yüklemek için ve seçeneklerini --global --tool-path atlar.

Yerel araçlar, .NET Core SDK 3.0'dan başlayarak kullanılabilir.

Genel araçlar, veya seçeneğini belirttiğinizde varsayılan olarak aşağıdaki -g dizinlere --global yüklenir:

İşletim Sistemi Yol
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Yerel araçlar, geçerli dizin altındaki bir.configdotnet-tools.json dosyasına eklenir. Henüz bir bildirim dosyası yoksa, aşağıdaki komutu çalıştırarak oluşturun:

dotnet new tool-manifest

Daha fazla bilgi için bkz. Yerel araç yükleme.

Bağımsız değişkenler

  • PACKAGE_NAME

    Yüklenilen .NET aracını NuGet paketin adı/kimliği.

Seçenekler

  • --add-source <SOURCE>

    yükleme sırasında kullanmak üzere ek bir NuGet paket kaynağı ekler. Akışlara, bir öncelik sırasına göre değil, paralel olarak erişilir. Aynı paket ve sürüm birden çok akışda varsa, en hızlı akış kazanır. daha fazla bilgi için bkz. NuGet paketi yüklendiğinde ne olur?.

  • --configfile <FILE>

    NuGet yapılandırma dosyası (nuget.config) . Belirtilirse, yalnızca bu dosyanın ayarları kullanılır. Belirtilmezse, geçerli dizinden yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz. Ortak NuGet Yapılandırmaları.

  • --disable-parallel

    Birden çok proje paralel olarak geri yüklemeyi engelleme.

  • --framework <FRAMEWORK>

    Aracı yüklemek için hedef çerçeveyi belirtir. .NET SDK varsayılan olarak en uygun hedef çerçeveyi seçmeye çalışır.

  • -g|--global

    Yüklemenin kullanıcı çapında olduğunu belirtir. seçeneğiyle --tool-path birleştirilene değildir. ve'nin her --global ikisini de --tool-path yok, yerel bir araç yüklemesini belirtir.

  • -?|-h|--help

    Komutunun nasıl kullanıla ilgili bir açıklama yazdırır.

  • --ignore-failed-sources

    Paket kaynak hatalarına uyarı olarak davran.

  • --interactive

    Komutun kullanıcı girişini veya eylemlerini durdurması ve beklemesini sağlar. Örneğin, kimlik doğrulamasını tamamlamak için.

  • --local

    Aracı ve yerel araç bildirimini güncelleştirin. seçeneği veya --global seçeneğiyle --tool-path birleştirilene değildir.

  • --no-cache

    Paketleri ve HTTP isteklerini önbelleğe alın.

  • --tool-manifest <PATH>

    Bildirim dosyasının yolu.

  • --tool-path <PATH>

    Genel Aracın yükln olduğu konumu belirtir. PATH mutlak veya göreli olabilir. PATH yoksa, komut onu oluşturmaya çalışır. ve'nin her --global ikisini de --tool-path yok, yerel bir araç yüklemesini belirtir.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntılı düzeyini ayarlar. İzin verilen değerler q[uiet] : , , , ve m[inimal] n[ormal] d[etailed] diag[nostic] . Daha fazla bilgi için bkz. LoggerVerbosity.

  • --version <VERSION_NUMBER>

    Yüklenilen aracın sürümü. Varsayılan olarak, en son kararlı paket sürümü yüklenir. Aracın önizleme veya eski sürümlerini yüklemek için bu seçeneği kullanın.

Örnekler

  • dotnet tool install -g dotnetsay

    Dotnetsay'i varsayılan konuma genel bir araç olarak yükleme.

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

    Dotnetsay'i belirli bir dizinde genel bir araç Windows ekler.

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

    Dotnetsay'ı belirli bir Linux/macOS dizinine genel bir araç olarak ekler.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Dotnetsay 2.0.0 sürümünü genel bir araç olarak yüklüdür.

  • dotnet tool install dotnetsay

    Geçerli dizin için yerel bir araç olarak dotnetsay'i yüklür.

Ayrıca bkz.