Commande dotnet

  • Article

Cet article s’applique à : ✔️ SDK .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 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] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Description

La commande dotnet a deux fonctions :

  • Elle fournit des commandes permettant d’utiliser les 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 pour imprimer 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 .dll d’application pour exécuter l’application. Pour exécuter l’application, vous devez rechercher et exécuter le point d’entrée, qui, dans le cas des applications console, est la méthode Main. Par exemple, dotnet myapp.dll exécute l’application myapp. Pour plus d’informations sur les options de déploiement, consultez Déploiement d’applications .NET.

Options

Différentes options sont disponibles pour :

  • Afficher des informations sur l’environnement.
  • Exécuter une commande.
  • Exécuter une application.

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

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

  • --info

    Affiche des informations détaillées sur une installation .NET et l’environnement de la machine, par exemple le système d’exploitation actuel, ainsi que le SHA de validation de la version du .NET.

  • --version

Affiche la version du SDK .NET utilisée par les commandes dotnet, qui peut être affecté par un fichier global.json. Disponible uniquement lorsque le SDK est installé.

  • --list-runtimes

    Affiche la liste des runtimes .NET installés. Une version x86 du SDK répertorie uniquement les runtimes x86 et une version x64 du SDK répertorie uniquement les runtimes x64.

  • --list-sdks

    Affiche la liste des SDK .NET installés.

  • -?|-h|--help

    Imprime une liste des commandes disponibles.

Options d’exécution d’une commande

Les options suivantes concernent dotnet avec 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 toutes les commandes. Consultez la page de la commande spécifique pour déterminer si cette option est disponible.

  • -?|-h|--help

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

  • command options

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

Options d’exécution d’une application

Les options suivantes sont disponibles lorsque dotnet exécute une application. Par exemple : dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

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

  • --additional-deps <PATH>

    Chemin d’un fichier .deps.json supplémentaire. Un fichier deps.json contient une liste de dépendances, des dépendances de compilation et des informations de version utilisées pour tenter de résoudre les conflits d’assemblys. Pour plus d’informations, consultez Runtime Configuration Files sur GitHub.

  • --roll-forward <SETTING> **

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

    • LatestPatch - Restauration par progression vers la version de correctif la plus élevée. Cette valeur désactive la restauration par progression d’une version mineure.
    • Minor - Restauration par progression vers la version mineure supérieure 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 - Restauration par progression vers la version majeure supérieure la plus basse, et la version mineure la plus basse, si la version majeure demandée est manquante. Si la version majeure demandée est présente, la stratégie Minor est utilisée.
    • LatestMinor - Restauration par progression vers la version mineure la plus élevée, si la version mineure demandée est présente. Conçu pour les scénarios d’hébergement de composant.
    • LatestMajor - Restauration par progression vers la version majeure la plus élevée et la version mineure la plus élevée, si la version majeure demandée est présente. Conçu pour les scénarios d’hébergement de composant.
    • Disable - Ne pas effectuer de restauration par progression. 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é d’effectuer une restauration par progression vers les derniers correctifs. Cette valeur est recommandée uniquement à des fins de test.

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

    Le comportement de la restauration par progression peut également être configuré dans une propriété de fichier projet, une propriété du fichier de configuration du runtime et une variable d’environnement. Pour plus d’informations, consultez Restauration par progression d’un 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 de framework dans le fichier .runtimeconfig.json de l’application. 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 de framework, l’utilisation de cette option peut entraîner des erreurs.

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

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

  • --depsfile <PATH>

    Chemin d’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 SDK .NET.

  • --runtimeconfig <PATH>

    Chemin d’un fichier runtimeconfig.json. Un fichier runtimeconfig.json contient des paramètres d’exécution et est généralement nommé <applicationname>.runtimeconfig.json. Pour plus d’informations, consultez Paramètres de configuration du runtime .NET.

Commandes dotnet

Général

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 Nettoie les sorties de build.
dotnet exec Exécute une application .NET.
dotnet help Affiche plus de documentation détaillée en ligne pour la commande.
dotnet migrate Migre un projet Preview 2 valide vers un projet SDK .NET Core 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 à partir de votre code.
dotnet publish Publie une application .NET dépendante du framework ou autonome.
dotnet restore Restaure les dépendances d’une application donnée.
dotnet run Exécute l’application à partir de la source.
dotnet sdk check Affiche l’état à jour des versions du SDK et du runtime installés.
dotnet sln Options pour ajouter, supprimer et lister des projets dans un fichier solution.
dotnet store Stocke les assemblys dans le magasin de packages de runtime.
dotnet test Exécute des tests à l’aide d’un lanceur de tests.

Références de projets

Commande Fonction
dotnet add reference Ajoute une référence au projet.
dotnet list reference Liste les références du projet.
dotnet remove reference Supprime une référence de projet.

Packages NuGet

Commande Fonction
dotnet add package Ajoute un package NuGet.
dotnet remove package Supprime un package NuGet.

Commandes NuGet

Commande Fonction
dotnet nuget delete Supprime ou retire un package du serveur.
dotnet nuget push Effectue une transmission de type push d’un package sur le serveur et le publie.
dotnet nuget locals Efface ou liste les ressources NuGet locales telles que le cache de requête HTTP, 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.
dotnet nuget list source Répertorie toutes les sources NuGet configurées.
dotnet nuget remove source Supprime une source NuGet.
dotnet nuget update source Met à jour une source NuGet.

Commandes de charge de travail

Commande Fonction
dotnet workload install Installe une charge de travail facultative.
dotnet workload list Répertorie toutes les charges de travail installées.
dotnet workload repair Répare toutes les charges de travail installées.
dotnet workload search Répertorie les charges de travail sélectionnées ou toutes les charges de travail disponibles.
dotnet workload uninstall Désinstalle une charge de travail.
dotnet workload update Réinstalle toutes les charges de travail installées.

Commandes des outils globaux, de chemin d’accès aux outils et 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’accès aux outils et outils locaux. Pour plus d’informations, consultez Vue d’ensemble des outils .NET.

Commande Fonction
dotnet tool install Installe un outil sur votre ordinateur.
dotnet tool list Répertorie tous les outils globaux, de chemin d’accès aux outils ou locaux actuellement installés sur votre ordinateur.
dotnet tool search Recherche sur NuGet.org les outils qui ont le terme de recherche spécifié dans leurs nom ou métadonnées.
dotnet tool uninstall Désinstalle un outil de votre ordinateur.
dotnet tool update Met à jour un outil installé sur votre ordinateur.

Outils supplémentaires

Les outils supplémentaires suivants sont disponibles dans le cadre du SDK .NET :

Outil Fonction
dev-certs Crée et gère les certificats de développement.
ef Outils en ligne de commande Entity Framework Core.
user-secrets Gère les secrets de développement de l’utilisateur.
watch Observateur de fichiers qui redémarre ou recharge à chaud une application lorsqu’il détecte des modifications apportées au 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