A sintaxe de um comando consiste basicamente nas regras de execução do comando. Você precisa saber como ler a notação de sintaxe ao aprender a usar um comando para que possa executá-lo corretamente.
Como você provavelmente já viu aqui na TopGadget e talvez outros sites, comandos do prompt de comando, comandos do DOS, e até mesmo muitos comandos de partida são descritos com todos os tipos de barras, suportes, itálico, etc. Depois de saber que todas essas marcas se referem a , você pode examinar a sintaxe de qualquer comando e saber imediatamente quais opções são necessárias e quais opções podem ser usadas com quais outras opções.
Dependendo da fonte, você pode ver uma sintaxe ligeiramente diferente quando usada para descrever comandos. Usamos um método que a Microsoft tem usado historicamente e toda a sintaxe de comando que já vimos em qualquer site é extremamente semelhante, mas lembre-se de que você deve seguir a chave de sintaxe que pertence aos comandos que está lendo e não assumir que todos sites e documentação usam exatamente o mesmo método.
Chave de sintaxe de comando
A seguinte chave de sintaxe descreve como cada notação na sintaxe de um comando deve ser usada. Sinta-se à vontade para fazer referência a isso enquanto examinamos os três exemplos abaixo da tabela.
| Tabela de referência de sintaxe de comando | |
|---|---|
| Notação | Significado |
| Negrito | Os itens em negrito devem ser digitados exatamente como são mostrados, o que inclui quaisquer palavras em negrito, barras, dois pontos, etc. |
| itálico | Itens em itálico são itens que você deve fornecer. Não tome um item em itálico literalmente e use-o no comando conforme mostrado. |
| Espaço | Todos os espaços devem ser interpretados literalmente. Se a sintaxe de um comando tiver espaço, use esse espaço ao executar o comando. |
| [Texto entre colchetes] | Todos os itens dentro de um colchete são opcionais. Os colchetes não devem ser interpretados literalmente, portanto, não os use ao executar um comando. |
| Texto fora dos colchetes | Qualquer texto que não esteja entre colchetes é obrigatório. Na sintaxe de muitos comandos, o único texto que não está entre um ou mais colchetes é o próprio nome do comando. |
| {Texto entre chaves} | Os itens dentro de uma chave são opções, das quais você deve escolher apenas uma . As chaves não devem ser interpretadas literalmente, portanto, não as use ao executar um comando. |
| Barra Vertical | | Barras verticais são usadas para separar itens entre colchetes e colchetes. Não interprete as barras verticais literalmente – não as use ao executar comandos. |
| Elipse … | Uma reticência significa que um item pode ser repetido indefinidamente. Não digite reticências literalmente ao executar um comando e tome cuidado ao usar espaços e outros itens necessários conforme mostrado ao repetir itens. |
Os colchetes às vezes também são chamados de colchetes, os colchetes às vezes são chamados de colchetes ondulados ou em forma de flor e as barras verticais às vezes são chamadas de tubos, linhas verticais ou barras verticais. Independentemente de como você os chame, nenhum deve ser interpretado literalmente ao executar um comando.
Exemplo # 1: Comando Vol
Esta é a sintaxe do comando vol, um comando disponível no Prompt de Comando em todas as versões do sistema operacional Windows:
vol [ unidade: ]
A palavra vol está em negrito, o que significa que deve ser interpretada literalmente. Também está fora de quaisquer colchetes, o que significa que é obrigatório. Vamos dar uma olhada nos colchetes alguns parágrafos abaixo.
O volume seguinte é um espaço. Os espaços na sintaxe de um comando devem ser interpretados literalmente, portanto, ao executar o comando vol, será necessário colocar um espaço entre vol e qualquer coisa que venha a seguir.
Os colchetes indicam que tudo o que está contido neles é opcional – o que quer que esteja lá não é necessário para o comando funcionar, mas pode ser algo que você deseja usar, dependendo da finalidade para a qual está usando o comando. Os colchetes nunca devem ser interpretados literalmente, portanto, nunca os inclua ao executar um comando.
Dentro dos colchetes está a palavra drive em itálico , seguida de dois pontos em negrito. Qualquer coisa em itálico é algo que você deve fornecer, não interpretar literalmente. Nesse caso, uma unidade está se referindo a uma letra de unidade, portanto, você deve fornecer uma letra de unidade aqui. Assim como com vol, uma vez que: está em negrito, deve ser digitado como mostrado.
Com base em todas essas informações, aqui estão algumas maneiras válidas e inválidas de executar o comando vol e por quê:
vol
Válido: o comando vol pode ser executado sozinho porque drive : é opcional porque está entre colchetes.
vol d
Inválido: desta vez, a parte opcional do comando está sendo usada, especificando a unidade como d , mas os dois pontos foram esquecidos. Lembre-se de que sabemos que os dois pontos acompanham a unidade porque estão incluídos no mesmo conjunto de colchetes e sabemos que devem ser usados literalmente porque estão em negrito.
vol e: /p
Inválida: O / p opção não foi listado na sintaxe de comando para o comando vol não é executado quando usá-lo.
vol c:
Válido: neste caso, o argumento opcional drive : foi usado da maneira pretendida.
Exemplo 2: Comando de desligamento
A sintaxe listada aqui é para o comando shutdown e é obviamente muito mais complexa do que no exemplo de comando vol acima. No entanto, com base no que você já sabe, há muito pouco a aprender aqui:
shutdown [/i | /l | /s | /r | /g | /a | /p | /h | /e] [/f] [/m \\computername] [/t xxx] [/d [p:|u:]xx:yy] [/c “comment“]
Lembre-se de que os itens entre colchetes são sempre opcionais, os itens fora dos colchetes são sempre obrigatórios, os itens em negrito e os espaços são sempre literais e os itens em itálico devem ser fornecidos por você.
O grande novo conceito neste exemplo é a barra vertical. Barras verticais entre colchetes indicam escolhas opcionais. Portanto, no exemplo acima, você pode, mas não precisa, escolher incluir uma das seguintes opções ao executar um comando de desligamento: /i, /l, /s, /r, /g, /a, /p, /h ou /e. Como os colchetes, as barras verticais existem para explicar a sintaxe do comando e não devem ser interpretadas literalmente.
O comando shutdown também possui uma opção aninhada em [ /d [ p: | u: ] xx : yy ] – basicamente, uma opção dentro de uma opção.
Como com o comando vol no Exemplo 1 acima, aqui estão algumas maneiras válidas e inválidas de usar o comando shutdown:
shutdown /r /s
Inválido: As opções / r e / s não podem ser utilizados em conjunto. Essas barras verticais indicam opções, das quais você pode escolher apenas uma.
shutdown /s p:0:0
Inválido: Usar / s é perfeitamente normal, mas o uso de p: 0: 0 não é porque essa opção está disponível apenas com a opção / d , que esquecemos de usar. O uso correto seria desligamento / s / dp: 0: 0 .
shutdown /r /f /t 0
Válido: todas as opções foram usadas corretamente desta vez. A opção / r não foi usada com nenhuma outra escolha dentro de seu conjunto de colchetes, e as opções / f e / t foram usadas conforme descrito na sintaxe.
Exemplo # 3: Comando de uso de rede
Para nosso exemplo final, vamos dar uma olhada no comando net use, um dos comandos net. A sintaxe do comando net use é um pouco confusa, então a abreviamos abaixo para tornar a explicação um pouco mais fácil (veja a sintaxe completa aqui ):
net use [{devicename | *}] [\\computername\sharename [{password | *}]] [/persistent:{yes | no}] [/savecred] [/delete]
O comando net use tem duas instâncias de uma nova notação, a chave. Uma chave indica que uma, e apenas uma, das opções, separada por uma ou mais barras verticais, é necessária . Isso é diferente do colchete com barras verticais que indica escolhas opcionais.
Vejamos alguns usos válidos e inválidos do uso da rede:
net use e: * \\server\files
Inválido: o primeiro conjunto de colchetes significa que você pode especificar um nome de dispositivo ou usar o caractere curinga * – você não pode fazer os dois. Tanto net use e: \\ server \ files ou net use * \\ server \ files seriam formas válidas de executar net use neste caso.
net use * \\appsvr01\source 1lovet0visitcanada /persistent:no
Válido: Usamos corretamente várias opções nesta execução de net use, incluindo uma opção aninhada. Usamos * quando necessário para escolher entre ele e especificar um nome de dispositivo , especificamos um compartilhamento [ fonte ] em um servidor [ appsvr01 ] e, em seguida, escolhemos especificar uma { senha } para esse compartilhamento, 1lovet0visitcanada , em vez de forçar o uso da rede para peça-nos um { * }. Também decidimos não permitir que essa nova unidade compartilhada seja reconectada automaticamente na próxima vez que iniciarmos o computador [ / persistent: no ].
net use /persistent
Inválido: neste exemplo, optamos por usar a opção opcional / persistente, mas esquecemos de incluir os dois pontos ao lado dela e também esquecemos de escolher entre as duas opções obrigatórias, sim ou não , entre as chaves. Executando net use / persistent: yes teria sido um uso válido de net use.
