Share via

dotnet-kommando

  • Artikel

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

Name

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

Synopsis

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

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

dotnet -h|--help

Så här kör du 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] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Description

Kommandot dotnet har två funktioner:

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

    Skapar till exempel dotnet build 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 i fallet med konsolappar är Main metoden . Kör till exempel dotnet myapp.dll programmet myapp . Mer information om distributionsalternativ finns i Distribution av .NET-program .

Alternativ

Det finns olika alternativ för:

  • Visar information om miljön.
  • Köra 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. 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 incheckning av 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

    Skriver ut en lista över installerade .NET-körningar. En x86-version av SDK visar endast x86-körningar, och en x64-version av SDK visar endast x64-körningar.

  • --list-sdks

    Skriver ut en lista över installerade .NET SDK:er.

  • -?|-h|--help

    Skriver ut en lista över tillgängliga kommandon.

Alternativ för att köra ett kommando

Följande alternativ gäller för dotnet med ett kommando. Exempel: dotnet build --help eller dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Aktiverar diagnostiska utdata.

  • -v|--verbosity <LEVEL>

    Anger kommandots detaljnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Stöds inte i alla kommandon. Se den specifika kommandosidan 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 vidarebefordrad distribution tillämpas på appen. SETTING kan vara ett av följande värden. Om inget anges Minor är standardvärdet.

    • LatestPatch – Gå vidare till den högsta korrigeringsversionen. Detta inaktiverar delversionsfördrullning.
    • Minor – Gå vidare till den lägsta högre delversionen om den begärda delversionen saknas. Om den begärda delversionen finns används LatestPatch-principen.
    • Major – Gå vidare till den lägsta högre huvudversionen och den lägsta delversionen om den begärda högre versionen saknas. Om den begärda huvudversionen finns används delprincipen.
    • LatestMinor – Gå vidare till den högsta delversionen, även om den begärda delversionen finns. Avsedd för scenarier för komponentvärdar.
    • LatestMajor – Gå vidare till högsta högre och högsta delversion, även om den begärda huvudversionen 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 vidarebefordra till de senaste korrigeringarna. Det här värdet rekommenderas endast för testning.

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

    Beteendet för vidarebefordran kan också konfigureras i en projektfilegenskap, en körningskonfigurationsfilegenskap och en miljövariabel. Mer information finns i Runtime-distribution av högre version.

  • --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 .runtimeconfig.json -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 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 Konfigurationsinställningar för .NET-körning.

dotnet-kommandon

Allmänt

Kommando Funktion
dotnet-version Skapar ett .NET-program.
dotnet build-server Interagerar med servrar som startas av ett bygge.
dotnet clean Rensa build-utdata.
dotnet exec Kör ett .NET-program.
dotnet-hjälp Visar mer detaljerad dokumentation online för kommandot.
dotnet migrate Migrerar ett giltigt förhandsversion 2-projekt till ett .NET Core SDK 1.0-projekt.
dotnet msbuild Ger åtkomst till MSBuild-kommandoraden.
dotnet new Initierar ett C#- eller F#-projekt för en viss mall.
dotnet pack Skapar ett NuGet-paket med din kod.
dotnet publish Publicerar ett .NET-ramverksberoende eller självständigt program.
dotnet-återställning Återställer beroendena för ett visst program.
dotnet run Kör programmet från källan.
dotnet sdk check Visar aktuell 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 add reference Lägger till en projektreferens.
dotnet-listreferens Visar en lista över projektreferenser.
dotnet remove-referens Tar bort en projektreferens.

NuGet-paket

Kommando Funktion
dotnet add package Lägger till ett NuGet-paket.
dotnet remove-paket Tar bort ett NuGet-paket.

NuGet-kommandon

Kommando Funktion
dotnet nuget delete Tar bort eller avlistar ett paket från servern.
dotnet nuget push Push-överför ett paket till servern och publicerar det.
dotnet nuget locals Rensar eller listar lokala NuGet-resurser som 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 Uppdateringar en NuGet-källa.

Arbetsbelastningskommandon

Kommando Funktion
installation av dotnet-arbetsbelastning Installerar en valfri arbetsbelastning.
lista över dotnet-arbetsbelastningar Visar en lista över alla installerade arbetsbelastningar.
reparation av dotnet-arbetsbelastning Reparerar alla installerade arbetsbelastningar.
dotnet-arbetsbelastningssökning Visa en lista över valda arbetsbelastningar eller alla tillgängliga arbetsbelastningar.
avinstallera dotnet-arbetsbelastning Avinstallerar en arbetsbelastning.
dotnet-arbetsbelastningsuppdatering Installerar om alla installerade arbetsbelastningar.

Kommandon för globala verktyg, verktygsvägar 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 är installerade på datorn.
sök efter dotnet-verktyg Söker NuGet.org efter verktyg som har den angivna söktermen i namn eller metadata.
avinstallation av dotnet-verktyget Avinstallerar ett verktyg från datorn.
dotnet tool update Uppdateringar ett verktyg som är installerat på datorn.

Fler 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.
watch 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