Delen via


dotnet-opdracht

Dit artikel is van toepassing op: ✔️ .NET Core 3.1 SDK en latere versies

Naam

dotnet - Het algemene stuurprogramma voor de .NET CLI.

Samenvatting

Voor informatie over de beschikbare opdrachten en de omgeving:

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

dotnet -h|--help

Een opdracht uitvoeren (vereist SDK-installatie):

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

Een toepassing uitvoeren:

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]

Beschrijving

De dotnet opdracht heeft twee functies:

  • Het biedt opdrachten voor het werken met .NET-projecten.

    Hiermee wordt bijvoorbeeld dotnet build een project gebouwd. Elke opdracht definieert zijn eigen opties en argumenten. Alle opdrachten ondersteunen de optie voor het --help afdrukken van korte documentatie over het gebruik van de opdracht.

  • Er worden .NET-toepassingen uitgevoerd.

    U geeft het pad op naar een toepassingsbestand .dll om de toepassing uit te voeren. Als u de toepassing wilt uitvoeren, moet u het toegangspunt zoeken en uitvoeren, wat in het geval van console-apps de Main methode is. Voert bijvoorbeeld dotnet myapp.dll de myapp toepassing uit. Zie .NET-toepassingsimplementatie voor meer informatie over implementatieopties.

Opties

Er zijn verschillende opties beschikbaar voor:

  • Informatie over de omgeving weergeven.
  • Een opdracht uitvoeren.
  • Een toepassing uitvoeren.

Opties voor het weergeven van omgevingsgegevens en beschikbare opdrachten

De volgende opties zijn beschikbaar wanneer dotnet deze door zichzelf worden gebruikt, zonder een opdracht of toepassing op te geven die moet worden uitgevoerd. Bijvoorbeeld dotnet --info of dotnet --version. Ze drukken informatie over de omgeving af.

  • --info

    Geeft gedetailleerde informatie weer over een .NET-installatie en de computeromgeving, zoals het huidige besturingssysteem, en doorvoer SHA van de .NET-versie.

  • --version

Hiermee wordt de versie van de .NET SDK afgedrukt die wordt gebruikt door dotnet opdrachten. Dit kan worden beïnvloed door een global.json-bestand . Alleen beschikbaar wanneer de SDK is geïnstalleerd.

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

    Hiermee wordt een lijst afgedrukt met de geïnstalleerde .NET-runtimes voor de architectuur van de aangeroepen dotnet. Een x86-versie van dotnet lijsten alleen x86-runtimes en een x64-versie van dotnet lijsten alleen x64-runtimes.

    .NET 10 en latere versies ondersteunen het --arch argument. Als deze is opgegeven en niet hetzelfde is als de dotnet architectuur, zoekt u naar een .NET-installatie van de opgegeven architectuur en worden alle runtimes afgedrukt die daar zijn geïnstalleerd. Toegestane waarden zijn arm64, x64 en x86. De dotnet/runtime-opslagplaats bevat de volledige lijst met geldige architectuurwaarden.

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

    Hiermee wordt een lijst afgedrukt met de geïnstalleerde .NET SDK's voor de architectuur van de aangeroepen dotnet. Een x86-versie van dotnet lijsten alleen x86 SDK's en een x64-versie van dotnet lijsten alleen x64 SDK's.

    .NET 10 en latere versies ondersteunen het --arch argument. Als deze is opgegeven en niet hetzelfde is als de dotnet architectuur, zoekt u naar een .NET-installatie van de opgegeven architectuur en drukt u alle DAAR geïnstalleerde SDK's af. Toegestane waarden zijn arm64, x64 en x86. De dotnet/runtime-opslagplaats bevat de volledige lijst met geldige architectuurwaarden.

  • -?|-h|--help

    Hiermee wordt een lijst met beschikbare opdrachten afgedrukt.

Opties voor het uitvoeren van een opdracht

De volgende opties zijn bedoeld voor dotnet een opdracht. Bijvoorbeeld dotnet build --help of dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Hiermee schakelt u diagnostische uitvoer in.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. Niet ondersteund in elke opdracht. Zie de specifieke opdrachtpagina om te bepalen of deze optie beschikbaar is.

  • -?|-h|--help

    Hiermee wordt documentatie afgedrukt voor een bepaalde opdracht. Geeft bijvoorbeeld dotnet build --help help weer voor de build opdracht.

  • command options

    Elke opdracht definieert opties die specifiek zijn voor die opdracht. Zie een specifieke opdrachtpagina voor een lijst met beschikbare opties.

Opties voor het uitvoeren van een toepassing

De volgende opties zijn beschikbaar wanneer dotnet een toepassing wordt uitgevoerd. Bijvoorbeeld: dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Pad met testbeleid en assembly's. Herhaal de optie om meerdere paden op te geven.

  • --additional-deps <PATH>

    Pad naar een extra .deps.json-bestand . Een deps.json-bestand bevat een lijst met afhankelijkheden, compilatieafhankelijkheden en versie-informatie die wordt gebruikt om assemblyconflicten te verhelpen. Zie Runtime-configuratiebestanden op GitHub voor meer informatie.

  • --roll-forward <SETTING>

    Hiermee bepaalt u hoe roll forward wordt toegepast op de app. Dit SETTING kan een van de volgende waarden zijn. Als dit niet is opgegeven, Minor is dit de standaardwaarde.

    • LatestPatch - Doorsturen naar de hoogste patchversie. Hierdoor wordt het terugdraaien van secundaire versies uitgeschakeld.
    • #D0: rol door naar de laagste hogere secundaire versie als de aangevraagde secundaire versie ontbreekt. Als de aangevraagde secundaire versie aanwezig is, wordt het LatestPatch-beleid gebruikt.
    • #D0: rol door naar de laagste hogere primaire versie en de laagste secundaire versie als de aangevraagde primaire versie ontbreekt. Als de aangevraagde primaire versie aanwezig is, wordt het secundaire beleid gebruikt.
    • LatestMinor - Rol door naar de hoogste secundaire versie, zelfs als de aangevraagde secundaire versie aanwezig is. Bedoeld voor scenario's voor het hosten van onderdelen.
    • LatestMajor - Rol door naar de hoogste primaire en hoogste secundaire versie, zelfs als de aangevraagde primaire versie aanwezig is. Bedoeld voor scenario's voor het hosten van onderdelen.
    • Disable - Ga niet vooruit. Alleen binden aan de opgegeven versie. Dit beleid wordt niet aanbevolen voor algemeen gebruik, omdat hiermee de mogelijkheid om door te schakelen naar de nieuwste patches wordt uitgeschakeld. Deze waarde wordt alleen aanbevolen voor testen.

    Met uitzondering van Disablealle instellingen wordt de meest beschikbare patchversie gebruikt.

    Gedrag voor doorsturen kan ook worden geconfigureerd in een eigenschap van een projectbestand, een eigenschap van een runtime-configuratiebestand en een omgevingsvariabele. Zie De runtime-roll forward van de primaire versie voor meer informatie.

  • --fx-version <VERSION>

    Versie van de .NET-runtime die moet worden gebruikt om de toepassing uit te voeren.

    Met deze optie wordt de versie van de eerste frameworkreferentie in het #D0-bestand van de toepassing overschreven. Dit betekent dat het alleen werkt zoals verwacht als er slechts één frameworkreferentie is. Als de toepassing meer dan één frameworkreferentie heeft, kan het gebruik van deze optie fouten veroorzaken.

Opties voor het uitvoeren van een toepassing met de exec opdracht

De volgende opties zijn alleen beschikbaar wanneer dotnet een toepassing wordt uitgevoerd met behulp van de exec opdracht. Bijvoorbeeld: dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    Pad naar een deps.json-bestand . Een deps.json-bestand is een configuratiebestand dat informatie bevat over afhankelijkheden die nodig zijn om de toepassing uit te voeren. Dit bestand wordt gegenereerd door de .NET SDK.

  • --runtimeconfig <PATH>

    Pad naar een runtimeconfig.json-bestand . Een runtimeconfig.json-bestand bevat runtime-instellingen en heeft meestal de naam van de toepassingsnaam<>.runtimeconfig.json. Zie .NET Runtime-configuratie-instellingenvoor meer informatie.

dotnet-opdrachten

Algemeen

Opdracht Functie
dotnet-build Hiermee wordt een .NET-toepassing gebouwd.
dotnet build-server Interactie met servers die zijn gestart door een build.
dotnet schoon Schone build-uitvoer.
dotnet exec Hiermee wordt een .NET-toepassing uitgevoerd.
dotnet Help Toont meer gedetailleerde documentatie online voor de opdracht.
dotnet-migratie Hiermee migreert u een geldig Preview 2-project naar een .NET Core SDK 1.0-project.
dotnet msbuild Biedt toegang tot de MSBuild-opdrachtregel.
dotnet nieuwe Initialiseert een C#- of F#-project voor een bepaalde sjabloon.
dotnet pack Hiermee maakt u een NuGet-pakket van uw code.
dotnet publiceren Hiermee publiceert u een .NET Framework-afhankelijke of zelfstandige toepassing.
dotnet herstellen Hiermee worden de afhankelijkheden voor een bepaalde toepassing hersteld.
dotnet-uitvoering Hiermee wordt de toepassing vanuit de bron uitgevoerd.
dotnet sdk-controle Toont up-to-datumstatus van geïnstalleerde SDK- en Runtime-versies.
dotnet sln Opties voor het toevoegen, verwijderen en weergeven van projecten in een oplossingsbestand.
dotnet store Slaat assembly's op in het runtime-pakketarchief.
dotnet-test Voert tests uit met behulp van een testloper.

Projectverwijzingen

Opdracht Functie
dotnet-verwijzing toevoegen Voegt een projectreferentie toe.
dotnet-referentielijst Bevat projectverwijzingen.
dotnet-verwijzing verwijderen Hiermee verwijdert u een projectreferentie.

NuGet-pakketten

Opdracht Functie
dotnet-pakket toevoegen Hiermee voegt u een NuGet-pakket toe.
dotnet-pakketlijst Hiermee worden NuGet-pakketten weergegeven.
dotnet-pakket verwijderen Hiermee verwijdert u een NuGet-pakket.
zoeken in dotnet-pakketten Zoekt naar een NuGet-pakket.

NuGet-opdrachten

Opdracht Functie
dotnet nuget delete Hiermee verwijdert of verwijdert u een pakket van de server.
dotnet nuget push Pusht een pakket naar de server en publiceert het.
dotnet nuget locals Hiermee worden lokale NuGet-resources, zoals http-aanvraagcache, tijdelijke cache of globale pakketmap voor de hele machine, gewist of weergegeven.
dotnet nuget add source Hiermee voegt u een NuGet-bron toe.
dotnet nuget uitschakelen bron Hiermee schakelt u een NuGet-bron uit.
dotnet nuget inschakelen bron Hiermee schakelt u een NuGet-bron in.
dotnet nuget-lijstbron Een lijst met alle geconfigureerde NuGet-bronnen.
dotnet nuget remove source Hiermee verwijdert u een NuGet-bron.
dotnet nuget-updatebron Hiermee wordt een NuGet-bron bijgewerkt.

Workloadopdrachten

Opdracht Functie
dotnet-workload installeren Hiermee wordt een optionele workload geïnstalleerd.
lijst met dotnet-werkbelastingen Geeft een lijst weer van alle geïnstalleerde workloads.
dotnet-workloadherstel Herstelt alle geïnstalleerde workloads.
zoeken in dotnet-werkbelasting Een lijst weergeven met geselecteerde workloads of alle beschikbare workloads.
dotnet-workload verwijderen Hiermee verwijdert u een workload.
dotnet-werkbelasting bijwerken Installeert alle geïnstalleerde workloads opnieuw.

Opdrachten voor globale, hulpprogrammapaden en lokale hulpprogramma's

Hulpprogramma's zijn consoletoepassingen die zijn geïnstalleerd vanuit NuGet-pakketten en worden aangeroepen vanaf de opdrachtprompt. U kunt zelf hulpprogramma's schrijven of hulpprogramma's installeren die door derden zijn geschreven. Hulpprogramma's worden ook wel algemene hulpprogramma's, hulpprogramma's voor hulpprogramma's en lokale hulpprogramma's genoemd. Zie .NET-hulpprogramma's overzicht voor meer informatie.

Opdracht Functie
dotnet tool install Hiermee installeert u een hulpprogramma op uw computer.
lijst met dotnet-hulpprogramma's Een lijst met alle algemene, hulpprogrammapaden of lokale hulpprogramma's die momenteel op uw computer zijn geïnstalleerd.
zoeken in dotnet-hulpprogramma's Hiermee wordt NuGet.org gezocht naar hulpprogramma's met de opgegeven zoekterm in hun naam of metagegevens.
dotnet-hulpprogramma verwijderen Hiermee verwijdert u een hulpprogramma van uw computer.
dotnet tool update Hiermee werkt u een hulpprogramma bij dat op uw computer is geïnstalleerd.

Aanvullende hulpprogramma’s

De volgende extra hulpprogramma's zijn beschikbaar als onderdeel van de .NET SDK:

Werktuig Functie
dev-certs Hiermee maakt en beheert u ontwikkelingscertificaten.
Ef Entity Framework Core-opdrachtregelprogramma's.
gebruikersgeheimen Beheert ontwikkelingsgebruikersgeheimen.
horloge Een bestands-watcher die een toepassing opnieuw start of dynamisch laadt wanneer wijzigingen in de broncode worden gedetecteerd.

Typ voor meer informatie over elk hulpmiddel dotnet <tool-name> --help.

Voorbeelden

Maak een nieuwe .NET-consoletoepassing:

dotnet new console

Bouw een project en de bijbehorende afhankelijkheden in een bepaalde map:

dotnet build

Een toepassing uitvoeren:

dotnet exec myapp.dll
dotnet myapp.dll

Zie ook