perintah dotnet

  • Artikel

Artikel ini berlaku untuk: ️ .NET Core 3.1 SDK dan versi yang lebih baru

Nama

dotnet - Driver generik untuk .NET CLI.

Sinopsis

Untuk mendapatkan informasi tentang perintah yang tersedia dan lingkungannya:

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

Untuk menjalankan perintah (memerlukan instalasi SDK):

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

Untuk menjalankan aplikasi:

dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

dotnet exec [--additionalprobingpath] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Deskripsi

Perintah dotnet memiliki dua fungsi:

  • Fungsi ini menyediakan perintah untuk bekerja dengan proyek .NET.

    Misalnya, dotnet build membangun proyek. Setiap perintah mendefinisikan opsi dan argumennya sendiri. Semua perintah mendukung opsi --help untuk mencetak dokumentasi singkat tentang cara menggunakan perintah.

  • Perintah ini menjalankan aplikasi .NET.

    Anda menentukan jalur ke file .dll aplikasi untuk menjalankan aplikasi. Menjalankan aplikasi berarti menemukan dan menjalankan titik masuk, yang semisal dalam aplikasi konsol adalah metode Main. Misalnya, dotnet myapp.dll menjalankan aplikasi myapp. Baca penyebaran aplikasi .NET untuk mempelajari tentang opsi penyebaran.

Opsi

Opsi yang berbeda tersedia untuk:

  • Menampilkan informasi tentang lingkungan.
  • Menjalankan perintah.
  • Menjalankan aplikasi.

Opsi untuk menampilkan informasi lingkungan dan perintah yang tersedia

Opsi berikut tersedia saat dotnet digunakan dengan sendirinya, tanpa menentukan perintah atau aplikasi yang akan dijalankan. Misalnya, dotnet --info atau dotnet --version. Keduanya mencetak informasi tentang lingkungan.

  • --info

    Mencetak informasi rinci tentang penginstalan .NET dan lingkungan mesin, seperti sistem operasi saat ini, dan melakukan SHA versi .NET.

  • --version

Mencetak versi .NET SDK yang digunakan oleh dotnet perintah, yang mungkin dipengaruhi oleh file global.json . Hanya tersedia saat SDK diinstal.

  • --list-runtimes

    Mencetak daftar runtime .NET yang diinstal. Versi x86 dari SDK hanya mencantumkan x86 runtime, dan versi x64 dari SDK hanya mencantumkan runtime x64.

  • --list-sdks

    Mencetak daftar .NET SDK yang diinstal.

  • -?|-h|--help

    Mencetak daftar perintah yang tersedia.

Opsi untuk menjalankan perintah

Opsi berikut adalah untuk dotnet menggunakan perintah. Misalnya, dotnet build --help atau dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Mengaktifkan output diagnostik.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Tidak didukung di setiap perintah. Baca halaman perintah khusus untuk menentukan apakah opsi ini tersedia.

  • -?|-h|--help

    Mencetak dokumentasi untuk perintah tertentu. Misalnya, dotnet build --help menampilkan bantuan untuk build perintah.

  • command options

    Setiap perintah mendefinisikan opsi khusus untuk perintah itu. Baca halaman perintah khusus untuk mengetahui daftar opsi yang tersedia.

Opsi untuk menjalankan aplikasi

Opsi berikut tersedia saat dotnet menjalankan aplikasi. Contohnya:dotnet --roll-forward Major myapp.dll

  • --additionalprobingpath <PATH>

    Jalur yang berisi kebijakan penyelidikan dan rakitan untuk diselidiki. Ulangi opsi untuk menentukan beberapa jalur.

  • --additional-deps <PATH>

    Jalur ke file .deps.json tambahan. File deps.json berisi daftar dependensi, dependensi kompilasi, dan informasi versi yang digunakan untuk mengatasi konflik perakitan. Untuk informasi selengkapnya, lihat File Konfigurasi Runtime di GitHub.

  • --roll-forward <SETTING>

    Mengontrol cara gulung maju diterapkan ke aplikasi. SETTING dapat berupa salah satu dari nilai berikut. Jika tidak ditentukan, Minor adalah default.

    • LatestPatch - Gulung maju ke versi patch paling tinggi. Tindakan ini menonaktifkan versi kecil gulung maju.
    • Minor - Gulung maju ke versi kecil yang paling rendah, jika versi kecil yang diminta tidak ada. Jika ada versi kecil yang diminta, maka kebijakan LatestPatch digunakan.
    • Major - Gulung maju ke versi besar terendah yang lebih tinggi, dan versi kecil terendah, jika versi besar yang diminta tidak ada. Jika versi besar yang diminta ada, maka kebijakan Kecil digunakan.
    • LatestMinor - Gulung maju ke versi kecil tertinggi, meskipun ada versi kecil yang diminta. Ditujukan untuk skenario hosting komponen.
    • LatestMajor - Gulung maju ke versi besar tertinggi dan kecil tertinggi, meskipun ada versi besar yang diminta. Ditujukan untuk skenario hosting komponen.
    • Disable - Jangan gulung maju. Hanya ikat ke versi yang ditentukan. Kebijakan ini tidak disarankan untuk penggunaan umum karena menonaktifkan kemampuan untuk gulung maju ke patch terbaru. Nilai ini hanya disarankan untuk pengujian.

    Dengan pengecualian Disable, semua pengaturan akan menggunakan versi patch tertinggi yang tersedia.

    Perilaku gulung maju juga dapat dikonfigurasi dalam properti file proyek, properti file konfigurasi runtime, dan variabel lingkungan. Untuk informasi selengkapnya, lihat Gulung maju runtime versi besar.

  • --fx-version <VERSION>

    Versi runtime .NET digunakan untuk menjalankan aplikasi.

    Opsi ini menimpa versi referensi kerangka kerja pertama dalam file .runtimeconfig.json aplikasi. Ini berarti hanya berfungsi seperti yang diharapkan jika hanya ada satu referensi kerangka kerja. Jika aplikasi memiliki lebih dari satu referensi kerangka kerja, menggunakan opsi ini dapat menyebabkan kesalahan.

Opsi untuk menjalankan aplikasi dengan exec perintah

Opsi berikut hanya tersedia saat dotnet menjalankan aplikasi dengan menggunakan exec perintah . Contohnya:dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll

  • --depsfile <PATH>

    Jalur ke file deps.json . File deps.json adalah file konfigurasi yang berisi informasi tentang dependensi yang diperlukan untuk menjalankan aplikasi. File ini dihasilkan oleh .NET SDK.

  • --runtimeconfig <PATH>

    Jalur ke file runtimeconfig.json. File runtimeconfig.json berisi pengaturan run-time dan biasanya bernama <applicationname.runtimeconfig.json>. Untuk informasi selengkapnya, lihat Pengaturan konfigurasi runtime .NET.

perintah dotnet

Umum

Perintah Fungsi
build dotnet Membangun aplikasi .NET.
dotnet build-server Berinteraksi dengan server yang dimulai oleh build.
dotnet clean Membersihkan output build.
dotnet exec Menjalankan aplikasi .NET.
dotnet help Menampilkan dokumentasi yang lebih mendetail secara online untuk perintah tersebut.
dotnet migrate Memigrasikan proyek Preview 2 yang valid ke proyek .NET Core SDK 1.0.
dotnet msbuild Menyediakan akses ke baris perintah MSBuild.
dotnet new Menginisialisasi proyek C# atau F# untuk templat tertentu.
dotnet pack Membuat paket NuGet dari kode Anda.
dotnet publish Memublikasikan aplikasi yang dimuat sendiri atau tergantung pada kerangka kerja .NET.
pemulihan dotnet Mengembalikan dependensi untuk aplikasi tertentu.
dotnet run Menjalankan aplikasi dari sumber.
dotnet sdk check Menampilkan status terbaru dari SDK dan versi Runtime yang diinstal.
dotnet sln Opsi untuk menambah, menghapus, dan membuat daftar proyek dalam file solusi.
dotnet store Menyimpan rakitan di penyimpanan paket runtime.
dotnet test Menjalankan pengujian menggunakan test runner.

Referensi proyek

Perintah Fungsi
dotnet add reference Menambahkan referensi proyek.
dotnet list reference Mencantumkan referensi proyek.
dotnet remove reference Menghapus referensi proyek.

Paket NuGet

Perintah Fungsi
dotnet add package Menambahkan paket NuGet.
dotnet remove package Menghapus paket NuGet.

Perintah NuGet

Perintah Fungsi
dotnet nuget delete Menghapus atau membatalkan daftar paket dari server.
dotnet nuget push Mendorong paket ke server dan menerbitkannya.
dotnet nuget locals Menghapus atau mencantumkan sumber daya NuGet lokal seperti cache http-request, cache sementara, atau folder paket global seluruh mesin.
dotnet nuget add source Menambahkan sumber NuGet.
dotnet nuget disable source Menonaktifkan sumber NuGet.
dotnet nuget enable source Mengaktifkan sumber NuGet.
dotnet nuget list source Mencantumkan semua sumber NuGet yang dikonfigurasi.
dotnet nuget remove source Menghapus sumber NuGet.
dotnet nuget update source Memperbarui sumber NuGet.

Perintah beban kerja

Perintah Fungsi
dotnet workload install Menginstal beban kerja opsional.
dotnet workload list Mencantumkan semua beban kerja yang diinstal.
dotnet workload repair Memperbaiki semua beban kerja yang terpasang.
dotnet workload search Mencantumkan beban kerja yang dipilih atau semua beban kerja yang tersedia.
dotnet workload uninstall Menghapus instalan beban kerja.
dotnet workload update Menginstal ulang semua beban kerja yang diinstal.

Perintah alat global, jalur alat, dan alat lokal

Alat adalah aplikasi konsol yang diinstal dari paket NuGet dan dipanggil dari perintah. Anda dapat menulis alat sendiri atau menginstal alat yang ditulis oleh pihak ketiga. Alat juga dikenal sebagai alat global, alat jalur alat, dan alat lokal. Untuk informasi selengkapnya, lihat Gambaran alat .NET.

Perintah Fungsi
dotnet tool install Menginstal alat pada komputer Anda.
dotnet tool list Mencantumkan semua alat global, jalur alat, atau alat lokal yang saat ini diinstal di komputer Anda.
dotnet tool search Menelusuri NuGet.org untuk alat yang memiliki istilah pencarian tertentu dalam nama atau metadatanya.
dotnet tool uninstall Menghapus instalasi alat dari komputer Anda.
dotnet tool update Memperbarui alat yang diinstal pada komputer Anda.

Alat tambahan

Alat tambahan berikut tersedia sebagai bagian dari .NET SDK:

Alat Fungsi
dev-certs Membuat dan mengelola sertifikat pengembangan.
ef Alat baris perintah Inti Entity Framework.
user-secrets Mengelola rahasia pengguna pengembangan.
watch Pengamat file yang memulai ulang atau memuat ulang aplikasi saat mendeteksi perubahan dalam kode sumber.

Untuk informasi selengkapnya tentang setiap alat, ketik dotnet <tool-name> --help.

Contoh

Buat aplikasi konsol .NET baru:

dotnet new console

Bangun proyek dan dependensinya di direktori yang diberikan:

dotnet build

Jalankan aplikasi:

dotnet exec myapp.dll

dotnet myapp.dll

Lihat juga