Como Ler a Sintaxe da Linha de Comando do Windows

Se você está usando um PC com Windows, provavelmente já viu ou usou uma linha de comando para realizar alguma tarefa no seu PC com Windows. Se você precisar de ajuda com algum comando, há muitos sites que podem ajudá-lo com a sintaxe e o uso dos comandos. Mas, a menos que você saiba como ler essa sintaxe da linha de comando, essa ajuda não passa de uma string incompreensível.

Por exemplo, se você verificar a referência oficial da linha de comando para o comando attrib, verá a sintaxe da linha de comando algo como isto.

ATTRIB [{+R|-R}][{+A|-A}][{+S|-S}][{+H|-H}][[drive:][path] filename][/S[/D]]

Como você pode ver, a sintaxe da linha de comando acima contém todos os tipos de variações, como maiúsculas e minúsculas, e caracteres especiais como espaços, colchetes (“[ ]”), chaves (“({})”) e pipes (” | “). A linha de comando acima não faz sentido para um olho não treinado, mas informa sobre os diferentes parâmetros que você pode usar com o comando attrib.

Como Ler a Sintaxe do Comando

Uma sintaxe de comando nada mais é do que as regras que governam como um comando pode ser usado ou executado. A menos que você saiba como ler a sintaxe da linha de comando, não poderá usar ou entender os comandos corretamente ou em todo o seu potencial. Portanto, neste tutorial básico, vamos aprender alguns conceitos básicos sobre como ler a sintaxe da linha de comando. Conforme o exemplo, você pode pegar o comando “attrib” acima e usar as informações abaixo para interpretar esse comando.

Caractere Especial “+”: Sempre que você usar o caractere especial + na frente de um item ou parâmetro, significa que você está configurando esse parâmetro para a tarefa que está realizando.

Por exemplo, no comando attrib acima, sempre que você usar o parâmetro +R no comando, estará configurando o modo somente leitura para um arquivo ou pasta selecionada.

Caractere Especial “-”: Sempre que você usar o caractere especial - na frente de um item ou parâmetro, significa que você está limpando esse parâmetro para a tarefa que está realizando.

Por exemplo, no comando attrib acima, sempre que você usar o parâmetro -R no comando, estará removendo o modo somente leitura para um arquivo ou pasta selecionada.

Caracteres em Maiúsculas: Na sintaxe da linha de comando, os caracteres representados em maiúsculas são o que os usuários devem digitar exatamente. Quando digo caracteres, isso inclui todos os números, caracteres especiais e letras.

Por exemplo, no comando attrib acima, o comando base ATTRIB e os switches como -R, +A, /S, etc., devem ser usados como estão, sem quaisquer modificações. Portanto, o comando válido se parece com isto,

ATTRIB +R

mas não assim, que elimina o caractere especial “+”.

ATTRIB R

Caracteres em Minúsculas: Sempre que você ver a representação de caracteres em minúsculas, isso significa que o usuário deve fornecer as informações necessárias para que o comando seja executado corretamente.

Por exemplo, no comando attrib acima, você precisa fornecer informações como a unidade e o caminho do arquivo no lugar de [[drive:][path] filename]. Uma vez fornecidas, o comando se parece com isto.

ATTRIB C:\folder\file.txt

Pipes (Barras Verticais): Pipes ou barras verticais são usados para mostrar os vários parâmetros que você pode usar dentro dos colchetes ou chaves. Tem o mesmo significado que “ou…ou”, o que significa que apenas um dos parâmetros pode ser usado. Pipes ou barras verticais são apenas para ilustração e não devem ser usados com comandos reais.

Por exemplo, no comando attrib acima, você pode ver que os switches +R e -R estão separados por uma barra vertical, o que significa que são dois parâmetros diferentes e apenas um deles (ou +R ou -R) pode ser usado no comando real.

Chaves (“{ }”): Quaisquer itens ou parâmetros dentro de chaves são um conjunto de escolhas onde o usuário deve escolher um, ou seja, você pode escolher um parâmetro entre um grupo de parâmetros dentro das chaves. Além disso, você não deve usar chaves com comandos reais.

Por exemplo, a sintaxe do comando {+A | -A} sugere que você pode usar o switch +A ou -A no comando real, mas não ambos ao mesmo tempo, pois pertencem ao mesmo grupo. Portanto, o comando válido se parece com isto,

ATTRIB +A

mas não assim, que usa ambas as opções ao mesmo tempo.

ATTRIB +A -A

Colchetes (“[ ]”): Quaisquer itens ou parâmetros dentro de colchetes são opcionais, ou seja, cabe a você usar esses parâmetros ou não. Além disso, você não deve usar colchetes com comandos reais.

Por exemplo, no comando attrib acima, a sintaxe [{+R|-R}] sugere que você pode usar os parâmetros opcionais ou não (também, mantenha as chaves em mente). Portanto, qualquer um dos comandos abaixo é válido.

ATTRIB +R

ou

ATTRIB

Espaços: Mesmo os espaços têm significado na sintaxe do comando. Se você encontrar um espaço na sintaxe do comando, deve usá-lo ao executar o comando real.

Por exemplo, no comando attrib acima, você não deve eliminar nenhum dos espaços. Portanto, um comando válido se parecerá com isto,

ATTRIB +R -H

mas não assim, que elimina os espaços.

ATTRIB+R-H

Texto Fora dos Colchetes: Assim como os Espaços, qualquer texto fora dos colchetes deve ser usado e deve ser usado “como está” ao executar os comandos.

Por exemplo, no comando attrib acima, o comando base ATTRIB deve ser usado e deve ser usado como está. Portanto, o comando válido se parece com isto,

ATTRIB +R -H C:\folder\file.txt

e não assim, que elimina o uso do texto fora dos colchetes.

+R -H C:\folder\file.txt

Reticências (“…”): Reticências não são tão comuns em nenhuma sintaxe, mas se você ver uma reticência, isso significa que o item ou parâmetro pode ser repetido infinitamente.

Conclusão

Saber como interpretar a sintaxe da linha de comando é muito útil para entender e usar as referências de comando encontradas na documentação oficial e na Internet. Certamente, pode levar algum tempo para dominar essas regras de sintaxe, mas vale a pena.

Não se esqueça de compartilhar seus pensamentos usando o formulário de comentários abaixo.