Dela via

dotnet-kommando

Den här artikeln gäller för: ✔️ .NET 6 SDK och senare versioner

Namn

dotnet – Den allmänna drivrutinen för .NET CLI.

Sammanfattning

Så här hämtar du information om tillgängliga kommandon och miljön:

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

dotnet -h|--help

För att köra ett kommando (kräver SDK-installation):

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

Så här kör du ett program:

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]

Beskrivning

Kommandot dotnet har två funktioner:

  • Den innehåller kommandon för att arbeta med .NET-projekt.

    Skapar dotnet build till exempel ett projekt. Varje kommando definierar sina egna alternativ och argument. Alla kommandon stöder --help alternativet för att skriva ut kort dokumentation om hur du använder kommandot.

  • Den kör .NET-program.

    Du anger sökvägen till en programfil .dll för att köra programmet. Att köra programmet innebär att hitta och köra startpunkten, vilket när det gäller konsolappar är Main metoden. Kör till exempel dotnet myapp.dll programmet myapp . Mer information om distributionsalternativ finns i .NET-programdistribution .

Alternativ

Olika alternativ är tillgängliga för:

  • Visar information om miljön.
  • Kör ett kommando.
  • Köra ett program.

Alternativ för att visa miljöinformation och tillgängliga kommandon

Följande alternativ är tillgängliga när dotnet de används av sig själv, utan att ange ett kommando eller ett program som ska köras. Till exempel dotnet --info eller dotnet --version. De skriver ut information om miljön.

  • --info

    Skriver ut detaljerad information om en .NET-installation och datormiljön, till exempel det aktuella operativsystemet, och inchecknings-SHA för .NET-versionen.

  • --version

Skriver ut den version av .NET SDK som används av dotnet kommandon, som kan påverkas av en global.json fil. Endast tillgängligt när SDK:et är installerat.

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

    Skriver ut en lista över installerade .NET-körningar för arkitekturen för den anropade dotnet. En x86-version av dotnet listar endast x86-körningar och en x64-version av dotnet listar endast x64-körningar.

    .NET 10 och senare versioner stöder --arch argumentet. Om det anges och inte är samma som arkitekturen dotnet söker du efter en .NET-installation av den angivna arkitekturen och skriver ut alla körningar som är installerade där. Tillåtna värden är arm64, x64 och x86. Lagringsplatsen dotnet/runtime har en fullständig lista över giltiga arkitekturvärden.

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

    Skriver ut en lista över installerade .NET SDK:er för arkitekturen för den anropade dotnet. En x86-version av dotnet listar endast x86 SDK:er och en x64-version av dotnet listar endast x64 SDK:er.

    .NET 10 och senare versioner stöder --arch argumentet. Om det anges och inte är samma som arkitekturen dotnet söker du efter en .NET-installation av den angivna arkitekturen och skriver ut eventuella SDK:er som är installerade där. Tillåtna värden är arm64, x64 och x86. Lagringsplatsen dotnet/runtime har en fullständig lista över giltiga arkitekturvärden.

  • -?|-h|--help

    Skriver ut en lista över tillgängliga kommandon.

Alternativ för att köra ett kommando

Följande alternativ är till för dotnet med ett kommando. Till exempel dotnet build --help eller dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Aktiverar diagnostiska utdata.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Stöds inte i alla kommandon. Se en specifik kommandosida för att avgöra om det här alternativet är tillgängligt.

  • -?|-h|--help

    Skriver ut dokumentation för ett visst kommando. Visar till exempel dotnet build --help hjälp för build kommandot.

  • command options

    Varje kommando definierar alternativ som är specifika för det kommandot. En lista över tillgängliga alternativ finns på den specifika kommandosidan.

Alternativ för att köra ett program

Följande alternativ är tillgängliga när dotnet du kör ett program. Till exempel dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Sökväg som innehåller avsökningsprincip och sammansättningar för avsökning. Upprepa alternativet för att ange flera sökvägar.

  • --additional-deps <PATH>

    Sökväg till ytterligare en .deps.json fil. En deps.json fil innehåller en lista över beroenden, kompileringsberoenden och versionsinformation som används för att hantera sammansättningskonflikter. Mer information finns i Körningskonfigurationsfiler på GitHub.

  • --roll-forward <SETTING>

    Styr hur vidarekoppling tillämpas på appen. SETTING Kan vara något av följande värden. Om det inte anges Minor är standardvärdet.

    • LatestPatch – Rulla vidare till den högsta korrigeringsversionen. Detta inaktiverar delversionsfördrullning framåt.
    • Minor – Rulla vidare till den lägsta lägre delversionen om den begärda delversionen saknas. Om den begärda delversionen finns används LatestPatch-principen.
    • Major – Rulla vidare till den lägsta högre huvudversionen och den lägsta delversionen om den begärda huvudversionen saknas. Om den begärda huvudversionen finns används delprincipen.
    • LatestMinor – Rulla vidare till högsta delversion, även om den begärda delversionen finns. Avsedd för scenarier för komponentvärdar.
    • LatestMajor – Rulla vidare till högsta högre och högsta delversion, även om den begärda majoren finns. Avsedd för scenarier för komponentvärdar.
    • Disable - Rulla inte framåt. Bind endast till angiven version. Den här principen rekommenderas inte för allmän användning eftersom den inaktiverar möjligheten att rulla vidare till de senaste korrigeringarna. Det här värdet rekommenderas endast för testning.

    Med undantag för Disableanvänder alla inställningar den högsta tillgängliga korrigeringsversionen.

    Vidarekopplingsbeteende kan också konfigureras i en projektfilegenskap, en körningskonfigurationsfilegenskap och en miljövariabel. Mer information finns i Runtime för högre version och framåt.

  • --fx-version <VERSION>

    Version av .NET-körningen som ska användas för att köra programmet.

    Det här alternativet åsidosätter versionen av den första ramverksreferensen i programmets #D0-fil. Det innebär att det bara fungerar som förväntat om det bara finns en ramverksreferens. Om programmet har fler än en ramverksreferens kan det orsaka fel med det här alternativet.

Alternativ för att köra ett program med exec kommandot

Följande alternativ är endast tillgängliga när dotnet du kör ett program med hjälp exec av kommandot . Till exempel dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    Sökväg till en deps.json fil. En deps.json fil är en konfigurationsfil som innehåller information om beroenden som krävs för att köra programmet. Den här filen genereras av .NET SDK.

  • --runtimeconfig <PATH>

    Sökväg till en runtimeconfig.json fil. En runtimeconfig.json fil innehåller körningsinställningar och heter <vanligtvis applicationname>.runtimeconfig.json. Mer information finns i .NET-körningskonfigurationsinställningar.

dotnet-kommandon

Allmänt

Kommando Funktion
dotnet build Skapar ett .NET-program.
dotnet build-server Interagerar med servrar som startats av en version.
dotnet clean Rensa build-utdata.
dotnet exec Kör ett .NET-program.
dotnet-hjälp Visar mer detaljerad dokumentation online för kommandot.
dotnet msbuild Ger åtkomst till MSBuild-kommandoraden.
dotnet ny Initierar ett C#- eller F#-projekt för en viss mall.
dotnet pack Skapar ett NuGet-paket med koden.
dotnet publicera Publicerar ett .NET-ramverksberoende eller fristående program.
dotnet-återställning Återställer beroendena för ett visst program.
dotnet-körning Kör programmet från källan.
dotnet sdk-kontroll Visar up-to-date status för installerade SDK- och Runtime-versioner.
dotnet sln Alternativ för att lägga till, ta bort och lista projekt i en lösningsfil.
dotnet store Lagrar sammansättningar i runtime-paketarkivet.
dotnet-test Kör tester med hjälp av en testkörare.

Projektreferenser

Kommando Funktion
dotnet-referenstillägg Lägger till en projektreferens.
dotnet-referenslista Visar en lista med projektreferenser.
dotnet-referensborttagning Tar bort en projektreferens.

NuGet-paket

Kommando Funktion
dotnet-pakettillägg Lägger till ett NuGet-paket.
dotnet-paketlista Listar NuGet-paket.
ta bort dotnet-paket Tar bort ett NuGet-paket.
dotnet-paketsökning Söker efter ett NuGet-paket.

NuGet-kommandon

Kommando Funktion
dotnet nuget delete Tar bort eller avlistar ett paket från servern.
dotnet nuget push Skickar ett paket till servern och publicerar det.
dotnet nuget locals Rensar eller listar lokala NuGet-resurser, till exempel http-request cache, tillfällig cache eller mapp för globala paket för hela datorn.
dotnet nuget add source Lägger till en NuGet-källa.
dotnet nuget disable source Inaktiverar en NuGet-källa.
dotnet nuget enable source Aktiverar en NuGet-källa.
dotnet nuget list source Visar en lista över alla konfigurerade NuGet-källor.
dotnet nuget remove source Tar bort en NuGet-källa.
dotnet nuget-uppdateringskälla Uppdaterar en NuGet-källa.

Arbetsbelastningskommandon

Kommando Funktion
rensa dotnet-arbetsbelastning Tar bort arbetsbelastningskomponenter.
dotnet-arbetsbelastningskonfiguration Aktiverar eller inaktiverar uppdateringsläge för arbetsbelastningsuppsättningar.
dotnet-arbetsbelastningshistorik Visar alla installationsåtgärder för arbetsbelastningar.
dotnet-arbetsbelastning installera Installerar en valfri arbetsbelastning.
dotnet-arbetsbelastningslista Visar en lista över alla installerade arbetsbelastningar.
dotnet arbetsbelastning reparation Reparerar alla installerade arbetsbelastningar.
återställning av dotnet-arbetsbelastning Återställa arbetsbelastningar som krävs för ett projekt.
dotnet-arbetsbelastningssökning Visa en lista över valda arbetsbelastningar eller alla tillgängliga arbetsbelastningar.
dotnet-arbetsbelastning avinstallera Avinstallerar en arbetsbelastning.
dotnet-arbetsbelastningsuppdatering Installerar om alla installerade arbetsbelastningar.

Globala kommandon, verktygssökväg och lokala verktyg

Verktyg är konsolprogram som installeras från NuGet-paket och som anropas från kommandotolken. Du kan skriva verktyg själv eller installera verktyg som skrivits av tredje part. Verktyg kallas även globala verktyg, verktygssökvägsverktyg och lokala verktyg. Mer information finns i Översikt över .NET-verktyg.

Kommando Funktion
installation av dotnet-verktyget Installerar ett verktyg på datorn.
dotnet-verktygslista Visar en lista över alla globala verktyg, verktygssökvägar eller lokala verktyg som för närvarande är installerade på datorn.
sök efter dotnet-verktyg Söker NuGet.org efter verktyg som har den angivna söktermen i deras namn eller metadata.
avinstallera dotnet-verktyget Avinstallerar ett verktyg från datorn.
uppdatering av dotnet-verktyget Uppdaterar ett verktyg som är installerat på datorn.

Ytterligare verktyg

Följande ytterligare verktyg är tillgängliga som en del av .NET SDK:

Verktyg Funktion
dev-certs Skapar och hanterar utvecklingscertifikat.
Ef Entity Framework Core-kommandoradsverktyg.
användarhemligheter Hanterar utvecklingsanvändarhemligheter.
klocka En filväktare som startar om eller laddar om ett program när det identifierar ändringar i källkoden.

Om du vill ha mer information om varje verktyg skriver du dotnet <tool-name> --help.

Exempel

Skapa ett nytt .NET-konsolprogram:

dotnet new console

Skapa ett projekt och dess beroenden i en viss katalog:

dotnet build

Kör ett program:

dotnet exec myapp.dll

dotnet myapp.dll

Se även

  • Last updated on