dotnet parancs

Ez a cikk a következő verziókra vonatkozik: ✔️ .NET 6 SDK és újabb verziók

Név

dotnet - A .NET parancssori felület általános illesztőprogramja.

Áttekintés

Az elérhető parancsokkal és a környezettel kapcsolatos információk lekérése:

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

dotnet -h|--help

Parancs futtatásához (SDK-telepítés szükséges):

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

Alkalmazás futtatása:

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]

Leírás

A dotnet parancs két függvényt tartalmaz:

• Parancsokat biztosít a .NET-projektekhez.

  Például dotnet build létrehoz egy projektet. Minden parancs saját beállításokat és argumentumokat határoz meg. Minden parancs támogatja a --help parancs használatával kapcsolatos rövid dokumentáció nyomtatását.

• .NET-alkalmazásokat futtat.

  Megadhatja egy alkalmazásfájl .dll elérési útját az alkalmazás futtatásához. Az alkalmazás futtatásához meg kell keresnie és végre kell hajtania a belépési pontot, amely konzolalkalmazások esetén a Main módszer. Futtatja például dotnet myapp.dll az myapp alkalmazást. Az üzembe helyezési lehetőségekről a .NET-alkalmazások üzembe helyezéséről szóló cikkben olvashat.

Beállítások

A következő lehetőségek közül választhat:

• A környezettel kapcsolatos információk megjelenítése.
• Parancs futtatása.
• Alkalmazás futtatása.

A környezeti információk és az elérhető parancsok megjelenítésének lehetőségei

Az alábbi lehetőségek akkor érhetők el, ha dotnet önállóan használják, anélkül, hogy megadna egy parancsot vagy egy futtatandó alkalmazást. Például, dotnet --info vagy dotnet --version. A környezettel kapcsolatos információkat nyomtatják ki.

• --info

  Részletes információkat nyomtat ki a .NET-telepítésről és a gépi környezetről, például az aktuális operációs rendszerről, és véglegesíti a .NET-verzió SHA-ját.

• --version

A parancsok által dotnet használt .NET SDK verzióját nyomtatja ki, amelyet egyglobal.json fájl érinthet. Csak az SDK telepítésekor érhető el.

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

  Kinyomtatja a meghívott dotnetarchitektúra telepített .NET-futtatókörnyezeteinek listáját. A listák x86-os dotnet verziója csak az x86-os futtatókörnyezetek, a listák x64-es dotnet verziója pedig csak az x64-es futtatókörnyezetek.

  A .NET 10 és újabb verziói támogatják az argumentumot --arch . Ha meg van adva, és nem ugyanaz, mint az dotnet architektúra, megkeresi a megadott architektúra .NET-telepítését, és kinyomtatja az ott telepített futtatókörnyezeteket. Az engedélyezett értékek közé tartozik az arm64, az x64 és az x86. A dotnet/runtime adattár az érvényes architektúraértékek teljes listáját tartalmazza.

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

  Kinyomtatja a meghívott dotnetarchitektúra telepített .NET SDK-jainak listáját. A listák x86-os dotnet verziója csak x86 SDK-k, a listák x64-es dotnet verziója pedig csak x64 SDK-k.

  A .NET 10 és újabb verziói támogatják az argumentumot --arch . Ha meg van adva, és nem ugyanaz, mint az dotnet architektúra, megkeresi a megadott architektúra .NET-telepítését, és kinyomtatja az ott telepített SDK-kat. Az engedélyezett értékek közé tartozik az arm64, az x64 és az x86. A dotnet/runtime adattár az érvényes architektúraértékek teljes listáját tartalmazza.

• -?|-h|--help

  Kinyomtatja az elérhető parancsok listáját.

Parancs futtatásának lehetőségei

Az alábbi lehetőségeket egy paranccsal #D0. Például, dotnet build --help vagy dotnet build --verbosity diagnostic.

• -d|--diagnostics

  Engedélyezi a diagnosztikai kimenetet.

• -v|--verbosity <LEVEL>

  A parancs részletességi szintjét állítja be. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. Nem minden parancs támogatja. Tekintse meg az adott parancslapot annak megállapításához, hogy elérhető-e ez a lehetőség.

• -?|-h|--help

  Kiírja egy adott parancs dokumentációját. Megjeleníti például dotnet build --help a parancs súgóját build .

• command options

  Minden parancs az adott parancshoz tartozó beállításokat határozza meg. Az elérhető lehetőségek listáját az adott parancslapon találja.

Alkalmazások futtatásának lehetőségei

Az alkalmazások futtatásakor dotnet az alábbi lehetőségek érhetők el. Például: dotnet --roll-forward Major myapp.dll.

• --additionalprobingpath <PATH>

  Próbaszabályzatot és mintavételi szerelvényeket tartalmazó elérési út. Ismételje meg a beállítást több elérési út megadásához.

• --additional-deps <PATH>

  Egy további .deps.json fájl elérési útja. A deps.json fájlok a szerelvényütközések kezelésére használt függőségek, fordítási függőségek és verzióinformációk listáját tartalmazzák. További információ: Futtatókörnyezeti konfigurációs fájlok a GitHubon.

• --roll-forward <SETTING>

  Szabályozza, hogy a rendszer hogyan alkalmazza a visszaállítást az alkalmazásra. Az SETTING alábbi értékek egyike lehet. Ha nincs megadva, Minor akkor az alapértelmezett érték.

  • LatestPatch - Ugrás a legmagasabb javításverzióra. Ez letiltja az alverzió továbbgördítését.
  • Minor – Lépjen tovább a legalacsonyabb alverzióra, ha a kért alverzió hiányzik. Ha a kért alverzió jelen van, akkor a Rendszer a LatestPatch szabályzatot használja.
  • Major - Ha a főverzió hiányzik, lépjen tovább a legalacsonyabb nagyobb főverzióra és a legalacsonyabb alverzióra. Ha a kért főverzió jelen van, akkor a rendszer az Alszabályzatot használja.
  • LatestMinor - Lépjen tovább a legmagasabb alverzióra, még akkor is, ha a kért alverzió jelen van. Komponens-üzemeltetési forgatókönyvekhez készült.
  • LatestMajor - Lépjen tovább a legmagasabb főverzióra és a legmagasabb alverzióra, még akkor is, ha a kért főverzió jelen van. Komponens-üzemeltetési forgatókönyvekhez készült.
  • Disable - Ne lépkedjetek előre. Csak a megadott verzióhoz kötés. Ez a szabályzat nem ajánlott általános használatra, mert letiltja a legújabb javításokra való ugrás lehetőségét. Ez az érték csak teszteléshez ajánlott.

  A kivételével Disableminden beállítás a legmagasabb elérhető javításverziót fogja használni.

  A roll forward viselkedése konfigurálható projektfájl-tulajdonságban, futtatókörnyezet konfigurációs fájltulajdonságában és környezeti változójában is. További információ: Főverziós futtatókörnyezeti bevezetés.

• --fx-version <VERSION>

  Az alkalmazás futtatásához használandó .NET-futtatókörnyezet verziója.

  Ez a beállítás felülírja az alkalmazás .runtimeconfig.json fájljában található első keretrendszer-referencia verzióját. Ez azt jelenti, hogy csak akkor működik a várt módon, ha csak egy keretrendszerhivatkozás van. Ha az alkalmazás több keretrendszerhivatkozással is rendelkezik, a beállítás használata hibákat okozhat.

Alkalmazások parancsokkal való exec futtatásának lehetőségei

Az alábbi lehetőségek csak akkor érhetők el, ha dotnet egy alkalmazást a exec parancs használatával futtat. Például: dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

• --depsfile <PATH>

  Egy deps.json fájl elérési útja. A deps.json fájlok olyan konfigurációs fájlok, amelyek az alkalmazás futtatásához szükséges függőségekről tartalmaznak információkat. Ezt a fájlt a .NET SDK hozza létre.

• --runtimeconfig <PATH>

  Egy runtimeconfig.json fájl elérési útja. A runtimeconfig.json fájl futásidejű beállításokat tartalmaz, és általában <az alkalmazásnév>.runtimeconfig.json. További információ: .NET futtatókörnyezet konfigurációs beállításai.

dotnet parancsok

Általános

Parancs	Funkció
dotnet buildelési	.NET-alkalmazást hoz létre.
dotnet buildkiszolgáló	A build által indított kiszolgálókkal kommunikál.
dotnet clean	Tiszta buildkimenetek.
dotnet exec	.NET-alkalmazást futtat.
dotnet súgója	A parancs részletesebb dokumentációját online jeleníti meg.
dotnet msbuild	Hozzáférést biztosít az MSBuild parancssorhoz.
dotnet new	Inicializál egy C# vagy F# projektet egy adott sablonhoz.
dotnet pack	Létrehoz egy NuGet-csomagot a kódból.
dotnet közzétételi	Közzétesz egy .NET-keretrendszertől függő vagy önálló alkalmazást.
dotnet-visszaállítási	Visszaállítja egy adott alkalmazás függőségeit.
dotnet-futtatás	Az alkalmazást forrásból futtatja.
dotnet sdk ellenőrzése	A telepített SDK- és futtatókörnyezeti verziók up-to-date állapotát jeleníti meg.
dotnet sln	A megoldásfájlban lévő projektek hozzáadásának, eltávolításának és listázásának lehetőségei.
dotnet store	A szerelvényeket a futtatókörnyezeti csomagtárolóban tárolja.
dotnet-teszt	Tesztfuttatóval futtatja a teszteket.

Projekthivatkozások

Parancs	Funkció
dotnet-referencia hozzáadása	Hozzáad egy projekthivatkozást.
dotnet-referencialista	A projekthivatkozások listája.
dotnet-referencia eltávolítása	Eltávolít egy projekthivatkozást.

NuGet-csomagok

Parancs	Funkció
dotnet-csomag hozzáadása	Hozzáad egy NuGet-csomagot.
dotnet-csomaglista	A NuGet-csomagok listája.
dotnet-csomag eltávolítása	Eltávolít egy NuGet-csomagot.
dotnet-csomag keresése	NuGet-csomagot keres.

NuGet-parancsok

Parancs	Funkció
dotnet nuget delete	Töröl vagy töröl egy csomagot a kiszolgálóról.
dotnet nuget push	Leküld egy csomagot a kiszolgálóra, és közzéteszi azt.
dotnet nuget locals	Törli vagy listázza a helyi NuGet-erőforrásokat, például a http-request gyorsítótárat, az ideiglenes gyorsítótárat vagy a gépre kiterjedő globális csomagmappát.
dotnet nuget– forrás hozzáadása	Hozzáad egy NuGet-forrást.
dotnet nuget – forrás letiltása	Letiltja a NuGet-forrást.
dotnet nuget enable source	Engedélyezi a NuGet-forrást.
dotnet nuget list source	Felsorolja az összes konfigurált NuGet-forrást.
dotnet nuget eltávolítási forrás	Eltávolít egy NuGet-forrást.
dotnet nuget frissítési forrás	Frissíti a NuGet-forrást.

Számítási feladatok parancsai

Parancs	Funkció
a dotnet számítási feladatainak tisztítása	Eltávolítja a számítási feladatok összetevőit.
dotnet számítási feladatok konfigurációja	Engedélyezi vagy letiltja a számítási feladatokkal beállított frissítési módot.
dotnet számítási feladatok előzményei	Megjeleníti az összes számítási feladat telepítési műveletét.
dotnet számítási feladat telepítése	Nem kötelező számítási feladatot telepít.
dotnet számítási feladatlista	Felsorolja az összes telepített számítási feladatot.
dotnet számítási feladatok javítása	Az összes telepített számítási feladatot kijavítja.
dotnet számítási feladat visszaállítása	Projekthez szükséges számítási feladatok visszaállítása.
dotnet munkaterhelés keresés	A kijelölt számítási feladatok vagy az összes elérhető számítási feladat listázása.
dotnet számítási feladat eltávolítása	Eltávolít egy számítási feladatot.
dotnet számítási feladat frissítési	Újratelepíti az összes telepített számítási feladatot.

Globális, eszközútvonal és helyi eszközök parancsai

Az eszközök a NuGet-csomagokból telepített és a parancssorból meghívott konzolalkalmazások. Saját maga is írhat eszközöket, vagy harmadik felek által írt eszközöket telepíthet. Az eszközöket globális eszközöknek, eszközelérési eszközöknek és helyi eszközöknek is nevezik. További információért lásd: .NET-eszközök áttekintése.

Parancs	Funkció
dotnet eszköz telepítése	Telepít egy eszközt a gépére.
dotnet eszközlista	Felsorolja a számítógépen jelenleg telepített összes globális, eszközútvonal- vagy helyi eszközt.
dotnet tool search	Olyan eszközöket keres NuGet.org, amelyek nevében vagy metaadataiban szerepel a megadott keresési kifejezés.
dotnet eszköz eltávolítása	Eltávolít egy eszközt a gépről.
dotnet eszközfrissítés	Frissíti a számítógépre telepített eszközt.

További eszközök

A .NET SDK részeként a következő további eszközök érhetők el:

Eszköz	Funkció
dev-certs	Fejlesztési tanúsítványokat hoz létre és kezel.
Ef	Entity Framework Core parancssori eszközök.
felhasználói titkos kódok	Kezeli a fejlesztői felhasználói titkos kulcsokat.
néz	Egy fájlfigyelő, amely újraindítja vagy újra betölti az alkalmazást, amikor észleli a forráskód változásait.

Az egyes eszközökről további információt #B0.

Példák

Hozzon létre egy új .NET-konzolalkalmazást:

dotnet new console

Projekt és függőségeinek létrehozása egy adott könyvtárban:

dotnet build

Alkalmazás futtatása:

dotnet exec myapp.dll

dotnet myapp.dll

Lásd még

• A .NET SDK, a .NET CLI és a .NET futtatókörnyezet által használt környezeti változók
• Futtatókörnyezet konfigurációs fájljai
• .NET-futtatókörnyezet konfigurációs beállításai