dotnet-opdracht

Dit artikel is van toepassing op: ✔️ .NET 6 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 doorgaans de naam <applicationname>.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 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-werkbelasting opschonen	Hiermee verwijdert u workloadonderdelen.
configuratie van dotnet-werkbelasting	Hiermee schakelt u de updatemodus voor de workloadset in of uit.
dotnet-workloadgeschiedenis	Toont alle installatieacties voor werkbelastingen.
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.
dotnet-workload herstellen	Herstel workloads die vereist zijn voor een project.
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 (een .NET-tool installeren)	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