Bagikan melalui

perintah dotnet

Artikel ini berlaku untuk: ✔️ .NET 6 SDK dan versi yang lebih baru

Nama

dotnet - Driver generik untuk .NET CLI.

Sinopsis

Untuk mendapatkan informasi tentang perintah dan lingkungan yang tersedia:

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

dotnet -h|--help

Untuk menjalankan perintah (memerlukan penginstalan 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 <PATH>] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Deskripsi

Perintah dotnet memiliki dua fungsi:

  • Ini menyediakan perintah untuk bekerja dengan proyek .NET.

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

  • Ini menjalankan aplikasi .NET.

    Anda menentukan jalur ke file aplikasi .dll untuk menjalankan aplikasi. Untuk menjalankan aplikasi berarti menemukan dan menjalankan titik masuk, yang dalam kasus aplikasi konsol adalah metode #D0. Misalnya, dotnet myapp.dll menjalankan myapp aplikasi. Lihat 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. Mereka mencetak informasi tentang lingkungan.

  • --info

    Mencetak informasi terperinci tentang penginstalan .NET dan lingkungan komputer, seperti sistem operasi saat ini, dan menerapkan SHA dari 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 [--arch <ARCH>]

    Mencetak daftar runtime .NET yang diinstal untuk arsitektur yang dipanggil dotnet. Versi dotnet x86 hanya mencantumkan runtime x86, dan versi dotnet x64 hanya mencantumkan runtime x64.

    .NET 10 dan versi yang lebih baru mendukung --arch argumen . Jika ditentukan dan tidak sama dotnet dengan arsitektur, cari penginstalan .NET dari arsitektur yang ditentukan dan mencetak runtime yang diinstal di sana. Nilai yang diizinkan termasuk arm64, x64, dan x86. Repositori dotnet/runtime memiliki daftar lengkap nilai arsitektur yang valid.

  • --list-sdks [--arch <ARCH>]

    Mencetak daftar .NET SDK yang diinstal untuk arsitektur yang dipanggil dotnet. Versi dotnet x86 hanya mencantumkan X86 SDK, dan versi dotnet x64 hanya mencantumkan X64 SDK.

    .NET 10 dan versi yang lebih baru mendukung --arch argumen . Jika ditentukan dan tidak sama dotnet dengan arsitektur, cari penginstalan .NET dari arsitektur yang ditentukan dan mencetak SDK apa pun yang diinstal di sana. Nilai yang diizinkan termasuk arm64, x64, dan x86. Repositori dotnet/runtime memiliki daftar lengkap nilai arsitektur yang valid.

  • -?|-h|--help

    Mencetak daftar perintah yang tersedia.

Opsi untuk menjalankan perintah

Opsi berikut adalah untuk dotnet dengan 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. Lihat halaman perintah tertentu 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 menentukan opsi khusus untuk perintah tersebut. Lihat halaman perintah tertentu untuk 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 pemeriksaan dan rakitan untuk pemeriksaan. 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 bagaimana roll forward diterapkan ke aplikasi. SETTING bisa menjadi salah satu nilai berikut. Jika tidak ditentukan, Minor adalah default.

    • LatestPatch - Gulung maju ke versi patch tertinggi. Ini menonaktifkan penerusan versi minor.
    • Minor - Gulung maju ke versi minor terendah yang lebih tinggi, jika versi minor yang diminta hilang. Jika versi minor yang diminta ada, maka kebijakan LatestPatch digunakan.
    • Major - Gulung maju ke versi utama terendah yang lebih tinggi, dan versi minor terendah, jika versi utama yang diminta hilang. Jika versi utama yang diminta ada, maka kebijakan Minor digunakan.
    • LatestMinor - Gulung maju ke versi minor tertinggi, bahkan jika versi minor yang diminta ada. Ditujukan untuk skenario hosting komponen.
    • LatestMajor - Gulung maju ke versi minor tertinggi dan tertinggi, bahkan jika mayor yang diminta ada. Ditujukan untuk skenario hosting komponen.
    • Disable - Jangan bergerak maju. Hanya ikat ke versi yang ditentukan. Kebijakan ini tidak disarankan untuk penggunaan umum karena menonaktifkan kemampuan untuk meneruskan ke patch terbaru. Nilai ini hanya direkomendasikan untuk pengujian.

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

    Perilaku roll forward juga dapat dikonfigurasi dalam properti file proyek, properti file konfigurasi runtime, dan variabel lingkungan. Untuk informasi selengkapnya, lihat Penerusan roll runtime versi utama.

  • --fx-version <VERSION>

    Versi runtime .NET yang akan digunakan untuk menjalankan aplikasi.

    Opsi ini mengambil alih versi referensi kerangka kerja pertama dalam file aplikasi .runtimeconfig.json . 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 runtime dan biasanya diberi nama<> aplikasi.runtimeconfig.json. Untuk informasi selengkapnya, lihat pengaturan konfigurasi .NET runtime di .

perintah dotnet

Umum

Perintah Fungsi
build dotnet Membangun aplikasi .NET.
dotnet build-server Berinteraksi dengan server yang dimulai oleh build.
dotnet bersih Bersihkan output build.
dotnet exec Menjalankan aplikasi .NET.
bantuan dotnet Memperlihatkan dokumentasi yang lebih rinci secara online untuk perintah tersebut.
msbuild dotnet Menyediakan akses ke baris perintah MSBuild.
dotnet new Menginisialisasi proyek C# atau F# untuk templat tertentu.
paket dotnet Membuat paket NuGet kode Anda.
publikasikan dotnet Menerbitkan aplikasi yang bergantung pada kerangka kerja .NET atau mandiri.
pemulihan dotnet Memulihkan dependensi untuk aplikasi tertentu.
dotnet run Menjalankan aplikasi dari sumber.
pemeriksaan dotnet sdk Memperlihatkan status up-to-date dari versi SDK dan Runtime yang diinstal.
dotnet sln Opsi untuk menambahkan, menghapus, dan mencantumkan proyek dalam file solusi.
penyimpanan dotnet Menyimpan rakitan di penyimpanan paket runtime.
pengujian dotnet Menjalankan pengujian menggunakan runner pengujian.

Referensi proyek

Perintah Fungsi
tambahkan referensi dotnet Menambahkan referensi proyek.
daftar referensi dotnet Mencantumkan referensi proyek.
hapus referensi dotnet Menghapus referensi proyek.

Paket NuGet

Perintah Fungsi
penambahan paket dotnet Menambahkan paket NuGet.
daftar paket dotnet Mencantumkan paket NuGet.
hapus paket dotnet Menghapus paket NuGet.
pencarian paket dotnet Mencari paket NuGet.

Perintah NuGet

Perintah Fungsi
penghapusan nuget dotnet Menghapus atau membatalkan daftar paket dari server.
dotnet nuget push Mendorong paket ke server dan menerbitkannya.
lokal dotnet nuget Menghapus atau mencantumkan sumber daya NuGet lokal seperti cache permintaan http, cache sementara, atau folder paket global di seluruh komputer.
dotnet nuget tambahkan sumber Menambahkan sumber NuGet.
dotnet nuget nonaktifkan sumber Menonaktifkan sumber NuGet.
dotnet nuget aktifkan sumber Mengaktifkan sumber NuGet.
sumber daftar nuget dotnet Mencantumkan semua sumber NuGet yang dikonfigurasi.
dotnet nuget hapus sumber Menghapus sumber NuGet.
sumber pembaruan dotnet nuget Memperbarui sumber NuGet.

Perintah beban kerja

Perintah Fungsi
beban kerja dotnet bersih Menghapus komponen beban kerja.
konfigurasi beban kerja dotnet Mengaktifkan atau menonaktifkan mode pembaruan set beban kerja.
riwayat beban kerja dotnet Menampilkan semua tindakan penginstalan beban kerja.
penginstalan beban kerja dotnet Menginstal beban kerja opsional.
daftar beban kerja dotnet Mencantumkan semua beban kerja yang terinstal.
perbaikan beban kerja dotnet Memperbaiki semua beban kerja yang diinstal.
pemulihan beban kerja dotnet Memulihkan beban kerja yang diperlukan untuk proyek.
pencarian beban kerja dotnet Mencantumkan beban kerja yang dipilih atau semua beban kerja yang tersedia.
hapus instalan beban kerja dotnet Menghapus instalan beban kerja.
pembaruan beban kerja dotnet Menginstal ulang semua beban kerja yang terinstal.

Perintah global, jalur alat, dan alat lokal

Alat adalah aplikasi konsol yang diinstal dari paket NuGet dan dipanggil dari prompt 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 umum tentang alat .NET.

Perintah Fungsi
penginstalan alat dotnet Menginstal alat di komputer Anda.
daftar alat dotnet Mencantumkan semua alat global, jalur alat, atau lokal yang saat ini terinstal di komputer Anda.
pencarian alat dotnet Mencari NuGet.org untuk alat yang memiliki istilah pencarian yang ditentukan dalam nama atau metadatanya.
hapus instalan alat dotnet Menghapus instalan alat dari komputer Anda.
pembaruan alat dotnet 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 Entity Framework Core.
rahasia pengguna Mengelola rahasia pengguna pengembangan.
menonton Pengamat file yang memulai ulang atau memuat ulang aplikasi saat mendeteksi perubahan 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 tertentu:

dotnet build

Jalankan aplikasi:

dotnet exec myapp.dll

dotnet myapp.dll

Lihat juga

  • Last updated on