dotnet-opdracht

  • Artikel

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

Naam

dotnet - Het algemene stuurprogramma voor de .NET CLI.

Synopsis

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] [--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 bevat opdrachten voor het werken met .NET-projecten.

    Hiermee bouwt u dotnet build bijvoorbeeld een project. 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 uitvoert, betekent dit dat u het toegangspunt zoekt en uitvoert, wat in het geval van console-apps de Main methode is. Hiermee voert u dotnet myapp.dll bijvoorbeeld de myapp toepassing uit. Zie Implementatie van .NET-toepassingen 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 omgevingsinformatie en beschikbare opdrachten

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

  • --info

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

  • --version

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

  • --list-runtimes

    Hiermee wordt een lijst met de geïnstalleerde .NET-runtimes afgedrukt. Een x86-versie van de SDK bevat alleen x86-runtimes en een x64-versie van de SDK bevat alleen x64-runtimes.

  • --list-sdks

    Een lijst met de geïnstalleerde .NET SDK's afdrukken.

  • -?|-h|--help

    Een lijst met beschikbare opdrachten afdrukken.

Opties voor het uitvoeren van een opdracht

De volgende opties zijn voor dotnet met 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 zijn q[uiet], m[inimal], n[ormal], d[etailed]en diag[nostic]. Niet ondersteund in elke opdracht. Zie de specifieke opdrachtpagina om te bepalen of deze optie beschikbaar is.

  • -?|-h|--help

    Documentatie voor een bepaalde opdracht afdrukken. Geeft bijvoorbeeld dotnet build --help help weer voor de build opdracht.

  • command options

    Elke opdracht definieert opties die specifiek zijn voor die opdracht. Zie de 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 die moeten worden gecontroleerd. Herhaal de optie om meerdere paden op te geven.

  • --additional-deps <PATH>

    Pad naar een extra .deps.json-bestand . Een bestand deps.json bevat een lijst met afhankelijkheden, compilatieafhankelijkheden en versie-informatie die wordt gebruikt om assembly-conflicten op te lossen. Zie Runtime Configuration Files op GitHub voor meer informatie.

  • --roll-forward <SETTING>

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

    • LatestPatch - Doorschakelen naar de hoogste patchversie. Hierdoor wordt secundaire versie naar voren roll forward uitgeschakeld.
    • Minor - Doorschakelen naar de laagste hogere secundaire versie, als de aangevraagde secundaire versie ontbreekt. Als de aangevraagde secundaire versie aanwezig is, wordt het beleid LatestPatch gebruikt.
    • Major - Roll forward naar laagste hogere primaire versie en laagste secundaire versie, als de aangevraagde primaire versie ontbreekt. Als de aangevraagde primaire versie aanwezig is, wordt het secundaire beleid gebruikt.
    • LatestMinor - Doorschakelen naar de hoogste secundaire versie, zelfs als de aangevraagde secundaire versie aanwezig is. Bedoeld voor scenario's voor het hosten van onderdelen.
    • LatestMajor - Doordraaien naar hoogste primaire en hoogste secundaire versie, zelfs als aangevraagde primaire versie aanwezig is. Bedoeld voor scenario's voor het hosten van onderdelen.
    • Disable - Rol niet naar voren. Alleen binden aan de opgegeven versie. Dit beleid wordt niet aanbevolen voor algemeen gebruik, omdat het de mogelijkheid om door te schakelen naar de nieuwste patches wordt uitgeschakeld. Deze waarde wordt alleen aanbevolen voor het testen.

    Met uitzondering van Disablegebruiken alle instellingen de hoogst beschikbare patchversie.

    Roll forward gedrag kan ook worden geconfigureerd in een projectbestandseigenschap, een runtime-configuratiebestandseigenschap en een omgevingsvariabele. Zie Runtime roll forward van 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 framework-verwijzing in het bestand van .runtimeconfig.json 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 met informatie 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 <applicationname.runtimeconfig.json>. Zie Configuratie-instellingen voor .NET-runtime voor meer informatie.

dotnet-opdrachten

Algemeen

Opdracht Functie
dotnet-build Hiermee bouwt u een .NET-toepassing.
dotnet build-server Interactie met servers die zijn gestart door een build.
dotnet clean Build-uitvoer opschonen.
dotnet exec Hiermee wordt een .NET-toepassing uitgevoerd.
dotnet Help Toont meer gedetailleerde documentatie online voor de opdracht.
dotnet migrate Migreert een geldig Preview 2-project naar een .NET Core SDK 1.0-project.
dotnet msbuild Biedt toegang tot de MSBuild-opdrachtregel.
dotnet new Initialiseert een C#- of F#-project voor een bepaalde sjabloon.
dotnet pack Hiermee maakt u een NuGet-pakket van uw code.
dotnet publish Publiceert een .NET Framework-afhankelijke of zelfstandige toepassing.
dotnet herstellen Hiermee herstelt u de afhankelijkheden voor een bepaalde toepassing.
dotnet-uitvoering De toepassing wordt uitgevoerd vanuit de bron.
dotnet SDK-controle Toont de bijgewerkte status van geïnstalleerde SDK- en Runtime-versies.
dotnet sln Opties voor het toevoegen, verwijderen en vermelden van projecten in een oplossingsbestand.
dotnet store Slaat assembly's op in het runtimepakketarchief.
dotnet-test Voert tests uit met behulp van een testrunner.

Projectverwijzingen

Opdracht Functie
dotnet add reference Hiermee voegt u een projectreferentie toe.
Naslaginformatie over dotnet-lijsten Een lijst met projectverwijzingen.
dotnet remove reference Hiermee verwijdert u een projectreferentie.

NuGet-pakketten

Opdracht Functie
dotnet add package Hiermee voegt u een NuGet-pakket toe.
dotnet remove package Hiermee verwijdert u een NuGet-pakket.

NuGet-opdrachten

Opdracht Functie
dotnet nuget delete Hiermee verwijdert u een pakket van de server of verwijdert u de lijst met pakketten.
dotnet nuget push Pusht een pakket naar de server en publiceert het.
dotnet nuget locals Hiermee wist of vermeldt u lokale NuGet-resources, zoals http-aanvraagcache, tijdelijke cache of de map globale pakketten voor de hele machine.
dotnet nuget bron toevoegen Hiermee voegt u een NuGet-bron toe.
dotnet nuget source uitschakelen Hiermee schakelt u een NuGet-bron uit.
dotnet nuget enable source Hiermee schakelt u een NuGet-bron in.
bron van dotnet nuget-lijst Een lijst met alle geconfigureerde NuGet-bronnen.
dotnet nuget source verwijderen Hiermee verwijdert u een NuGet-bron.
dotnet nuget-updatebron Updates een NuGet-bron.

Workloadopdrachten

Opdracht Functie
dotnet-workload installeren Installeert een optionele workload.
dotnet-workloadlijst Een lijst met alle geïnstalleerde workloads.
dotnet-workload herstellen Herstelt alle geïnstalleerde workloads.
Dotnet-workload zoeken Geselecteerde workloads of alle beschikbare workloads weergeven.
Dotnet-workload verwijderen Hiermee verwijdert u een workload.
dotnet-werkbelasting bijwerken Installeert alle geïnstalleerde workloads opnieuw.

Opdrachten voor globale hulpprogramma's, hulpprogrammapaden en lokale hulpprogramma's

Hulpprogramma's zijn consoletoepassingen die worden 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 globale hulpprogramma's, hulpprogramma's voor pad naar hulpprogramma's en lokale hulpprogramma's genoemd. Zie Overzicht van .NET-hulpprogramma's voor meer informatie.

Opdracht Functie
dotnet-hulpprogramma installeren Hiermee installeert u een hulpprogramma op uw computer.
lijst met dotnet-hulpprogramma's Een lijst met alle algemene hulpprogramma's, hulpprogrammapaden of lokale hulpprogramma's die momenteel op uw computer zijn geïnstalleerd.
Zoeken in dotnet-hulpprogramma 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-hulpprogramma bijwerken Updates een hulpprogramma dat op uw computer is geïnstalleerd.

Aanvullende hulpprogramma’s

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

Hulpprogramma Functie
dev-certs Hiermee maakt en beheert u ontwikkelingscertificaten.
Ef Opdrachtregelprogramma's van Entity Framework Core.
gebruikersgeheimen Beheert gebruikersgeheimen voor ontwikkeling.
watch Een file watcher die opnieuw wordt opgestart of hot laadt een toepassing opnieuw wanneer wijzigingen in de broncode worden gedetecteerd.

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

Voorbeelden

Een nieuwe .NET-consoletoepassing maken:

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