Partager via

commande dotnet

Cet article s’applique à : ✔️ .NET Core 3.1 et versions ultérieures

Nom

dotnet - Pilote générique pour l’interface CLI .NET.

Synopsis

Pour obtenir des informations sur les commandes disponibles et l’environnement :

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

dotnet -h|--help

Pour exécuter une commande (nécessite l’installation du Kit de développement logiciel (SDK) :

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

Pour exécuter une application :

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]

Descriptif

La dotnet commande a deux fonctions :

  • Il fournit des commandes permettant d’utiliser des projets .NET.

    Par exemple, dotnet build génère un projet. Chaque commande définit ses propres options et arguments. Toutes les commandes prennent en charge l’option --help d’impression d’une brève documentation sur l’utilisation de la commande.

  • Elle exécute des applications .NET.

    Vous spécifiez le chemin d’accès à un fichier d’application .dll pour exécuter l’application. Pour exécuter l’application, vous pouvez rechercher et exécuter le point d’entrée, qui, dans le cas des applications console, est la méthode #D0. Par exemple, dotnet myapp.dll exécute l’application myapp . Consultez le déploiement d’applications .NET pour en savoir plus sur les options de déploiement.

Paramètres

Différentes options sont disponibles pour :

  • Affichage d’informations sur l’environnement.
  • Exécution d’une commande.
  • Exécution d’une application.

Options d’affichage des informations d’environnement et des commandes disponibles

Les options suivantes sont disponibles quand dotnet elles sont utilisées par elle-même, sans spécifier de commande ou d’application à exécuter. Par exemple, dotnet --info ou dotnet --version. Ils impriment des informations sur l’environnement.

  • --info

    Imprime des informations détaillées sur une installation .NET et l’environnement de l’ordinateur, comme le système d’exploitation actuel, et valide sha de la version .NET.

  • --version

Imprime la version du Kit de développement logiciel (SDK) .NET utilisée par dotnet les commandes, qui peuvent être affectées par un fichier global.json . Disponible uniquement lorsque le Kit de développement logiciel (SDK) est installé.

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

    Imprime la liste des runtimes .NET installés pour l’architecture de l’appelé dotnet. Une version x86 de dotnet listes uniquement des runtimes x86 et une version x64 de dotnet listes uniquement des runtimes x64.

    .NET 10 et versions ultérieures prennent en charge l’argument --arch . Si elle est spécifiée et non identique à l’architecture dotnet , recherche une installation .NET de l’architecture spécifiée et imprime tous les runtimes installés ici. Les valeurs autorisées incluent arm64, x64 et x86. Le dépôt dotnet/runtime contient la liste complète des valeurs d’architecture valides.

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

    Imprime une liste des kits SDK .NET installés pour l’architecture de l’appelé dotnet. Une version x86 de dotnet listes uniquement des kits sdk x86 et une version x64 de dotnet listes uniquement des kits sdk x64.

    .NET 10 et versions ultérieures prennent en charge l’argument --arch . Si elle est spécifiée et non identique à l’architecture dotnet , recherche une installation .NET de l’architecture spécifiée et imprime les kits SDK installés ici. Les valeurs autorisées incluent arm64, x64 et x86. Le dépôt dotnet/runtime contient la liste complète des valeurs d’architecture valides.

  • -?|-h|--help

    Imprime une liste de commandes disponibles.

Options d’exécution d’une commande

Les options suivantes concernent dotnet une commande. Par exemple, dotnet build --help ou dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Active la sortie de diagnostic.

  • -v|--verbosity <LEVEL>

    Définit le niveau de détail de la commande. Les valeurs autorisées sont q[uiet], m[inimal], n[ormal], d[etailed] et diag[nostic]. Non pris en charge dans chaque commande. Consultez la page de commandes spécifique pour déterminer si cette option est disponible.

  • -?|-h|--help

    Imprime la documentation d’une commande donnée. Par exemple, dotnet build --help affiche de l’aide pour la build commande.

  • command options

    Chaque commande définit des options spécifiques à cette commande. Consultez la page de commandes spécifique pour obtenir la liste des options disponibles.

Options d’exécution d’une application

Les options suivantes sont disponibles lors dotnet de l’exécution d’une application. Par exemple : dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Chemin contenant la stratégie de détection et les assemblys à sonder. Répétez l’option pour spécifier plusieurs chemins d’accès.

  • --additional-deps <PATH>

    Chemin d’accès à un fichier .deps.json supplémentaire. Un fichier deps.json contient une liste de dépendances, de dépendances de compilation et d’informations de version utilisées pour résoudre les conflits d’assembly. Pour plus d’informations, consultez Fichiers de configuration du runtime sur GitHub.

  • --roll-forward <SETTING>

    Contrôle la façon dont la restauration est appliquée à l’application. Il SETTING peut s’agir de l’une des valeurs suivantes. S’il n’est pas spécifié, Minor est la valeur par défaut.

    • LatestPatch - Effectuez une restauration vers la version de correctif la plus élevée. Cela désactive la restauration automatique des versions mineures.
    • Minor - Effectuez une restauration vers la version mineure la plus basse, si la version mineure demandée est manquante. Si la version mineure demandée est présente, la stratégie LatestPatch est utilisée.
    • Major - Effectuez une restauration vers la version principale la plus basse et la version mineure la plus basse, si la version principale demandée est manquante. Si la version principale demandée est présente, la stratégie mineure est utilisée.
    • LatestMinor - Transférer vers la version mineure la plus élevée, même si la version mineure demandée est présente. Destiné aux scénarios d’hébergement de composants.
    • LatestMajor - Effectuez une restauration vers la version mineure la plus élevée et la plus élevée, même si la version majeure demandée est présente. Destiné aux scénarios d’hébergement de composants.
    • Disable - Ne pas avancer. Lier uniquement à la version spécifiée. Cette stratégie n’est pas recommandée pour une utilisation générale, car elle désactive la possibilité de restaurer les derniers correctifs. Cette valeur est uniquement recommandée pour les tests.

    À l’exception de #B0, tous les paramètres utilisent la version de correctif la plus élevée disponible.

    Le comportement de restauration avant peut également être configuré dans une propriété de fichier projet, une propriété de fichier de configuration runtime et une variable d’environnement. Pour plus d’informations, consultez restauration du runtime de version majeure.

  • --fx-version <VERSION>

    Version du runtime .NET à utiliser pour exécuter l’application.

    Cette option remplace la version de la première référence d’infrastructure dans le fichier de l’application .runtimeconfig.json . Cela signifie qu’il fonctionne uniquement comme prévu s’il n’existe qu’une seule référence de framework. Si l’application a plusieurs références d’infrastructure, l’utilisation de cette option peut entraîner des erreurs.

Options d’exécution d’une application avec la exec commande

Les options suivantes sont disponibles uniquement lorsque vous dotnet exécutez une application à l’aide de la exec commande. Par exemple : dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    Chemin d’accès à un fichier deps.json . Un fichier deps.json est un fichier de configuration qui contient des informations sur les dépendances nécessaires pour exécuter l’application. Ce fichier est généré par le Kit de développement logiciel (SDK) .NET.

  • --runtimeconfig <PATH>

    Chemin d’accès à un fichier runtimeconfig.json . Un fichier runtimeconfig.json contient des paramètres d’exécution et est généralement nommé <nom d’application>.runtimeconfig.json. Pour plus d’informations, consultez Paramètres de configuration d’exécution .NET Core.

commandes dotnet

Généralités

Commande Fonction
dotnet build Génère une application .NET.
dotnet build-server Interagit avec les serveurs démarrés par une build.
dotnet clean Nettoyer les sorties de build.
dotnet exec Exécute une application .NET.
aide dotnet Affiche une documentation plus détaillée en ligne pour la commande.
dotnet migrate Migre un projet Preview 2 valide vers un projet .NET Core SDK 1.0.
dotnet msbuild Fournit l’accès à la ligne de commande MSBuild.
dotnet new Initialise un projet C# ou F# pour un modèle donné.
dotnet Pack Crée un package NuGet de votre code.
dotnet publish Publie une application .NET Framework dépendante ou autonome.
dotnet restore Restaure les dépendances d’une application donnée.
dotnet run Exécute l’application à partir de la source.
Vérification du kit de développement logiciel dotnet Affiche up-to-date d’état des versions installées du Kit de développement logiciel (SDK) et du runtime.
dotnet sln Options d’ajout, de suppression et de liste de projets dans un fichier de solution.
dotnet Store Stocke les assemblys dans le magasin de packages runtime.
test dotnet Exécute des tests à l’aide d’un exécuteur de test.

Références de projet

Commande Fonction
dotnet reference add Ajoute une référence de projet.
liste de référence dotnet Répertorie les références de projet.
dotnet reference remove Supprime une référence de projet.

Les packages NuGet

Commande Fonction
dotnet package add Ajoute un package NuGet.
liste de packages dotnet Répertorie les packages NuGet.
dotnet package remove Supprime un package NuGet.
recherche de package dotnet Recherche un package NuGet.

Commandes NuGet

Commande Fonction
dotnet nuget delete Supprime ou supprime une liste d’un package du serveur.
dotnet nuget push Envoie (push) un package au serveur et le publie.
dotnet nuget locals Efface ou répertorie les ressources NuGet locales telles que le cache http-request, le cache temporaire ou le dossier de packages globaux à l’échelle de l’ordinateur.
dotnet nuget add source Ajoute une source NuGet.
dotnet nuget disable source Désactive une source NuGet.
dotnet nuget enable source Active une source NuGet.
source de liste nuget dotnet Répertorie toutes les sources NuGet configurées.
dotnet nuget remove source Supprime une source NuGet.
source de mise à jour nuget dotnet Met à jour une source NuGet.

Commandes de charge de travail

Commande Fonction
installation de la charge de travail dotnet Installe une charge de travail facultative.
liste des charges de travail dotnet Répertorie toutes les charges de travail installées.
réparation de la charge de travail dotnet Répare toutes les charges de travail installées.
recherche de charge de travail dotnet Répertoriez les charges de travail sélectionnées ou toutes les charges de travail disponibles.
désinstallation de la charge de travail dotnet Désinstalle une charge de travail.
mise à jour de la charge de travail dotnet Réinstalle toutes les charges de travail installées.

Commandes d’outils globales, de chemin d’accès aux outils et d’outils locaux

Les outils sont des applications console installées à partir de packages NuGet et appelées à partir de l’invite de commandes. Vous pouvez écrire vous-même des outils ou installer des outils écrits par des tiers. Les outils sont également appelés outils globaux, outils de chemin d’outils et outils locaux. Pour plus d’informations, consultez vue d’ensemble des outils .NET.

Commande Fonction
Installation de l’outil dotnet Installe un outil sur votre ordinateur.
liste des outils dotnet Répertorie tous les outils globaux, de chemin d’accès aux outils ou locaux actuellement installés sur votre ordinateur.
Recherche d’outils dotnet Recherche NuGet.org des outils qui ont le terme de recherche spécifié dans leur nom ou métadonnées.
Désinstallation de l’outil dotnet Désinstalle un outil de votre ordinateur.
mise à jour de l’outil dotnet Met à jour un outil installé sur votre ordinateur.

Outils supplémentaires

Les outils supplémentaires suivants sont disponibles dans le cadre du Kit de développement logiciel (SDK) .NET :

Outil Fonction
dev-certs Crée et gère des certificats de développement.
Ef Outils en ligne de commande Entity Framework Core.
user-secrets Gère les secrets utilisateur de développement.
montre Observateur de fichiers qui redémarre ou recharge à chaud une application lorsqu’elle détecte les modifications dans le code source.

Pour plus d’informations sur chaque outil, tapez dotnet <tool-name> --help.

Exemples

Créez une application console .NET :

dotnet new console

Générez un projet et ses dépendances dans un répertoire donné :

dotnet build

Exécutez une application :

dotnet exec myapp.dll

dotnet myapp.dll

Voir aussi