La syntaxe d'une commande est essentiellement les règles d'exécution de la commande. Vous devez savoir comment lire la notation syntaxique lorsque vous apprenez à utiliser une commande afin de pouvoir l'exécuter correctement.
Comme vous l'avez probablement vu ici sur Lifewire et peut-être sur d'autres sites Web, les commandes d'invite de commande, les commandes DOS et même de nombreuses commandes d'exécution sont décrites avec toutes sortes de barres obliques, de crochets, d'italiques, etc. Une fois que vous savez ce que tout de ces marques se réfèrent, vous pouvez regarder la syntaxe de n'importe quelle commande et savoir immédiatement quelles options sont requises et quelles options peuvent être utilisées avec quelles autres options.
Selon la source, vous pouvez voir une syntaxe légèrement différente lorsqu'elle est utilisée pour décrire des commandes. Nous utilisons une méthode que Microsoft a historiquement utilisée, et toute la syntaxe de commande que nous avons jamais vue sur n'importe quel site est extrêmement similaire, mais rappelez-vous que vous devez suivre la clé de syntaxe qui se rapporte aux commandes que vous lisez et ne pas supposer que tout les sites Web et la documentation utilisent exactement la même méthode.
Clé de syntaxe de commande
La clé de syntaxe suivante décrit comment chaque notation dans la syntaxe d'une commande doit être utilisée. N'hésitez pas à vous y référer pendant que nous parcourons les trois exemples sous le tableau.
Table de référence de la syntaxe des commandes | |
---|---|
Notation | Signification |
Gras | Les éléments en gras doivent être saisis exactement tels qu'ils sont affichés, y compris les mots en gras, les barres obliques, les deux-points, etc. |
Italique | Les articles en italique sont des articles que vous devez fournir. Ne prenez pas un élément en italique au pied de la lettre et utilisez-le dans la commande comme indiqué. |
S p a c e s | Tous les espaces doivent être pris littéralement. Si la syntaxe d'une commande contient de l'espace, utilisez cet espace lors de l'exécution de la commande. |
[Texte entre parenthèses] | Tous les éléments entre parenthèses sont facultatifs. Les parenthèses ne doivent pas être prises littéralement, donc ne les utilisez pas lors de l'exécution d'une commande. |
Texte hors crochets | Tout texte non contenu entre parenthèses est obligatoire. Dans la syntaxe de nombreuses commandes, le seul texte non entouré d'un ou plusieurs crochets est le nom de la commande lui-même. |
{Texte entre accolades} | Les éléments entre accolades sont des options, dont vous devez choisir seulement one. Les accolades ne doivent pas être prises littéralement, donc ne les utilisez pas lors de l'exécution d'une commande. |
Vertical | bar | Les barres verticales sont utilisées pour séparer les éléments entre crochets et accolades. Ne prenez pas les barres verticales au pied de la lettre - ne les utilisez pas lors de l'exécution de commandes. |
Points de suspension … | Une ellipse signifie qu'un élément peut être répété indéfiniment. Ne tapez pas les points de suspension littéralement lors de l'exécution d'une commande et veillez à utiliser les espaces et les autres éléments requis, comme indiqué lors de la répétition des éléments. |
Les crochets sont aussi parfois appelés crochets, les accolades sont parfois appelées crochets ondulés ou crochets fleuris, et les barres verticales sont parfois appelées tuyaux, lignes verticales ou barres obliques verticales. Peu importe comment vous les appelez, aucune ne doit jamais être prise littéralement lors de l'exécution d'une commande.
Exemple 1: Commande Vol
Voici la syntaxe de la commande vol, une commande disponible à partir de l'invite de commande dans toutes les versions du système d'exploitation Windows:
vol [lecteur:]
Le mot vol est en gras, ce qui signifie qu'il doit être pris littéralement. Il est également en dehors de toutes les parenthèses, ce qui signifie qu'il est obligatoire. Nous allons jeter un œil aux crochets quelques paragraphes plus bas.
Suivant vol est un espace. Les espaces dans la syntaxe d'une commande doivent être pris littéralement, donc lorsque vous exécutez la commande vol, vous devrez mettre un espace entre vol et tout ce qui pourrait venir ensuite.
Les crochets indiquent que tout ce qu'ils contiennent est facultatif. Les parenthèses ne doivent jamais être prises littéralement, donc ne les incluez jamais lors de l'exécution d'une commande.
À l'intérieur des crochets se trouve le mot drive en italique, suivi de deux-points en gras. Tout ce qui est en italique est quelque chose que vous devez fournir, et non prendre au pied de la lettre. Dans ce cas, un lecteur fait référence à une lettre de lecteur, vous devrez donc fournir une lettre de lecteur ici. Tout comme vol, puisque : est en gras, il doit être saisi comme indiqué.
Basé sur toutes ces informations, voici quelques manières valides et non valides d'exécuter la commande vol et pourquoi:
vol
Valid: La commande vol peut être exécutée seule car le lecteur : est facultatif car il est entouré de crochets.
vol d
Invalid: Cette fois, la partie facultative de la commande est utilisée, en spécifiant le lecteur comme d, mais les deux-points ont été oubliés. N'oubliez pas que nous savons que les deux-points accompagnent le lecteur car ils sont inclus dans le même ensemble de crochets et nous savons qu'ils doivent être utilisés littéralement car ils sont en gras.
vol e: /p
Invalid: L'option /p n'était pas répertoriée dans la syntaxe de la commande, donc la commande vol ne s'exécute pas lors de l'utilisation ça.
vol c:
Valid: Dans ce cas, l'argument lecteur facultatif : a été utilisé comme prévu.
Exemple 2: Commande d'arrêt
La syntaxe indiquée ici concerne la commande shutdown et est évidemment beaucoup plus complexe que dans l'exemple de commande vol ci-dessus. Cependant, en vous basant sur ce que vous savez déjà, il n'y a en fait que très peu de choses à apprendre ici:
arrêt [ /i | /l | /s | /r | /g | /a | /p | /h | /e] [ /f] [ /m \\ nomordinateur] [ /t xxx] [ /d [ p: | u:] xx: yy] [/c " commentaire " ]
N'oubliez pas que les éléments entre parenthèses sont toujours facultatifs, les éléments en dehors des crochets sont toujours obligatoires, les éléments en gras et les espaces sont toujours littéraux et les éléments en italique doivent être fournis par vous.
Le grand nouveau concept dans cet exemple est la barre verticale. Les barres verticales entre parenthèses indiquent des choix facultatifs. Ainsi, dans l'exemple ci-dessus, vous pouvez, mais vous n'y êtes pas obligé, choisir d'inclure l'une des options suivantes lors de l'exécution d'une commande d'arrêt: /i, /l , /s, /r, /g, / a, /p, /h, ou /e Comme les parenthèses, il existe des barres verticales pour expliquer la syntaxe de la commande et ne doivent pas être pris au pied de la lettre.
La commande shutdown a également une option imbriquée dans [ /d [ p: | u:] xx : yy]-essentiellement, une option dans une option.
Comme avec la commande vol dans le premier exemple, voici quelques façons valides et non valides d'utiliser la commande shutdown:
arrêt /r /s
Invalid: Les options /r et /s ne peuvent pas être utilisées ensemble. Ces barres verticales indiquent des choix parmi lesquels vous ne pouvez en choisir qu'un.
arrêt /s p:0:0
Invalid: L'utilisation de /s est parfaitement correcte mais l'utilisation de p:0:0ne l'est pas car cette option n'est disponible qu'avec l'option /d , que nous avons oublié d'utiliser. L'utilisation correcte aurait été shutdown /s /d p:0:0.
arrêt /r /f /t 0
Valide: Toutes les options ont été utilisées correctement cette fois. L'option /r n'a été utilisée avec aucun autre choix dans son ensemble de crochets, et les /f et /t Les optionsont été utilisées comme décrit dans la syntaxe.
Exemple 3: Commande Net Use
Pour notre dernier exemple, regardons la commande net use, une des commandes net. Sa syntaxe est un peu brouillonne, nous l'avons donc abrégée ci-dessous pour en faciliter l'explication (voir la syntaxe complète ici):
net use [{ nom de l'appareil | }] [ nom de l'ordinateur nom de partage [{ mot de passe | }] [ /persistent: { yes | no }] [ /savecred] [ /delete]
La commande net use a deux instances d'une nouvelle notation: l'accolade. Une accolade indique qu'un, et un seul, des choix, séparés par une ou plusieurs barres verticales, est requis. Ceci est différent du crochet avec des barres verticales qui indique des choix optionnels.
Regardons quelques utilisations valides et invalides de l'utilisation du net:
net use e:\\server\files
Invalid: La première série d'accolades signifie que vous pouvez spécifier un nom de périphérique ou utiliser le caractère générique - vous ne pouvez pas faire les deux. Soit net use e: \\server\files ou net use\\server\files auraient été des moyens valides d'exécuter net use dans ce cas.
net use\\appsvr01\source 1lovet0visitcanada /persistent:no
Valid: Nous avons correctement utilisé plusieurs options dans cette exécution de net use, y compris une option imbriquée. Nous avons utilisé le lorsqu'il était nécessaire de choisir entre celui-ci et la spécification d'un nom de périphérique, nous avons spécifié un partage [source] sur un serveur [appsvr01], puis avons choisi de spécifier un { mot de passe } pour cela partager, 1lovet0visitcanada, au lieu de forcer net use à nous demander un {}. Nous avons également décidé de ne pas autoriser la reconnexion automatique de ce nouveau disque partagé au prochain démarrage de l'ordinateur [ /persistent:no].
utilisation du net /persistant
Invalid: Dans cet exemple, nous avons choisi d'utiliser le commutateur facultatif /persistent mais nous avons oublié d'inclure les deux-points à côté et également oublié de choisir entre les deux options requises, yes ou no, entre les accolades. L'exécution de net use /persistent:yes aurait été une utilisation valide de net use.