Partager via

commande dotnet

  • Article

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

Nom

#D0 : 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]

Description

La commande #D0 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 #D0 pour imprimer une brève documentation sur l’utilisation de la commande.

  • Elle exécute des applications .NET.

    Vous spécifiez le chemin d’accès à une application #D0 fichier 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, #D0 exécute l’application #D1. Consultez #B0 #C1 de 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 lorsque #D0 est utilisé par lui-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

    Imprime la liste des runtimes .NET installés. Une version x86 du Kit de développement logiciel (SDK) répertorie uniquement les runtimes x86 et une version x64 du Kit de développement logiciel (SDK) répertorie uniquement les runtimes x64.

  • --list-sdks

    Imprime la liste des kits SDK .NET installés.

  • -?|-h|--help

    Imprime une liste de commandes disponibles.

Options d’exécution d’une commande

Les options suivantes concernent #D0 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 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, #D0 affiche de l’aide pour la commande #D1.

  • 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 lorsque #D0 exécute 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 #B0 fichiers de configuration runtime #C1 sur GitHub.

  • --roll-forward <SETTING>

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

    • #D0 - Transférer vers la version de correctif la plus élevée. Cela désactive la restauration automatique des versions mineures.
    • #D0 - Transférer 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.
    • #D0 - Transférer 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.
    • #D0 - 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.
    • #D0 - Transférer 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.
    • #D0 - 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 #B0 runtime de version majeure #A1 .

  • --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 #D0 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 d’infrastructure, l’utilisation de cette option peut entraîner des erreurs.

Options d’exécution d’une application avec la commande #D0

Les options suivantes sont disponibles uniquement lorsque #D0 exécute une application à l’aide de la commande #D1. 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 #B0 paramètres de configuration du runtime .NET #A1.

commandes dotnet

Généralités

Commande Fonction
dotnet build Génère une application .NET.
#B0 #C1 de build dotnet Interagit avec les serveurs démarrés par une build.
#B0 #C1 dotnet clean Nettoyer les sorties de build.
#B0 #C1 dotnet exec Exécute une application .NET.
#B0 aide dotnet #C1 Affiche une documentation plus détaillée en ligne pour la commande.
#B0 dotnet migrate #C1 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.
#B0 dotnet new #C1 Initialise un projet C# ou F# pour un modèle donné.
#B0 #C1 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.
#B0'exécution dotnet #C1 Exécute l’application à partir de la source.
#B0 kit de développement logiciel (SDK) dotnet check #C1 Affiche up-to-date d’état des versions installées du Kit de développement logiciel (SDK) et du runtime.
#B0 dotnet sln #C1 Options d’ajout, de suppression et de liste de projets dans un fichier de solution.
#B0 magasin dotnet #C1 Stocke les assemblys dans le magasin de packages runtime.
dotnet test 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
#B0 supprimer dotnet nuget #C1 Supprime ou supprime une liste d’un package du serveur.
#B0 dotnet nuget push #C1 Envoie (push) un package au serveur et le publie.
#B0 locals nuget dotnet #C1 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.
#B0 dotnet nuget ajouter #C1 source Ajoute une source NuGet.
#B0 nuget dotnet disable source #C1 Désactive une source NuGet.
#B0 nuget dotnet active la source #C1 Active une source NuGet.
#B0 source de liste nuget dotnet #C1 Répertorie toutes les sources NuGet configurées.
#B0 dotnet nuget supprimer #C1 source Supprime une source NuGet.
#B0 source de mise à jour nuget dotnet #C1 Met à jour une source NuGet.

Commandes de charge de travail

Commande Fonction
dotnet workload install Installe une charge de travail facultative.
#B0 liste de charges de travail dotnet #C1 Répertorie toutes les charges de travail installées.
#B0 #C1 de réparation de charge de travail dotnet Répare toutes les charges de travail installées.
#B0 #C1 de recherche de charge de travail dotnet Répertoriez les charges de travail sélectionnées ou toutes les charges de travail disponibles.
#B0 charge de travail dotnet désinstaller #C1 Désinstalle une charge de travail.
#B0 mise à jour de la charge de travail dotnet #C1 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 #B0 vue d’ensemble des outils .NET #A1.

Commande Fonction
dotnet tool install Installe un outil sur votre ordinateur.
#B0 liste d’outils dotnet #C1 Répertorie tous les outils globaux, de chemin d’accès aux outils ou locaux actuellement installés sur votre ordinateur.
#B0 recherche d’outils dotnet #C1 Recherche NuGet.org des outils qui ont le terme de recherche spécifié dans leur nom ou métadonnées.
#B0 outil dotnet désinstaller #C1 Désinstalle un outil de votre ordinateur.
#B0 #C1 de 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
#B0 des certificats de développement #C1 Crée et gère des certificats de développement.
#B0 ef #C1 Outils en ligne de commande Entity Framework Core.
#B0 secrets utilisateur #C1 Gère les secrets utilisateur de développement.
#B0 regarder #C1 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 #B0 .

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