A sintaxe de um comando é basicamente as regras para executar o comando. Você precisa saber ler a notação de sintaxe ao aprender a usar um comando para poder executá-lo corretamente.
Como você provavelmente já viu aqui no Lifewire e talvez em outros sites, comandos do Prompt de Comando, comandos do DOS e até mesmo muitos comandos de execução são descritos com todos os tipos de barras, colchetes, itálicos, etc. dessas marcas se referem, você pode olhar para 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 percorremos os três exemplos abaixo da tabela.
| Tabela de referência de sintaxe de comando | |
|---|---|
| Notação | Significado |
| Negrito | Itens em negrito devem ser digitados exatamente como são mostrados, isso 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 como mostrado. |
| S p a c e s | Todos os espaços devem ser tomados literalmente. Se a sintaxe de um comando tiver espaço, use esse espaço ao executar o comando. |
| [Texto entre colchetes] | Qualquer item dentro de um colchete é opcional. 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 colchetes é o próprio nome do comando. |
| {Texto entre chaves} | Os itens dentro de uma chave são opções, das quais você must escolhe apenas one. Chaves não devem ser interpretadas literalmente, então não as use ao executar um comando. |
| Vertical | barra | Barras verticais são usadas para separar itens entre colchetes e colchetes. Não tome as barras verticais literalmente - não as use ao executar comandos. |
| Reticências … | Uma reticência significa que um item pode ser repetido indefinidamente. Não digite reticências literalmente ao executar um comando e tome cuidado para usar espaços e outros itens necessários conforme mostrado ao repetir itens. |
Os colchetes também são chamados de colchetes, colchetes às vezes são chamados de colchetes ondulados ou colchetes de flores, e as barras verticais às vezes são chamadas de tubos, linhas verticais ou barras verticais. Independentemente de como você os chama, nenhum deve ser interpretado literalmente ao executar um comando.
Exemplo 1: Comando Vol
Aqui está 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 tomada literalmente. Também está fora de quaisquer colchetes, o que significa que é obrigatório. Vamos dar uma olhada nos colchetes alguns parágrafos abaixo.
Seguinte vol é um espaço. Espaços na sintaxe de um comando devem ser tomados literalmente, então quando você estiver executando o comando vol, você precisará colocar um espaço entre vol e qualquer coisa que possa vir a seguir.
Os colchetes indicam que o que estiver dentro deles é opcional - o que quer que esteja lá não é necessário para o comando funcionar, mas pode ser algo que você queira usar, dependendo do que você está usando para o comando. Os colchetes nunca devem ser tomados literalmente, portanto, nunca os inclua ao executar um comando.
Dentro dos colchetes está a palavra drive em itálico, seguida por 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, forneça uma letra de unidade aqui. Assim como vol, como : 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
Valid: O comando vol pode ser executado sozinho porque a unidade : é opcional porque está entre colchetes.
vol d
Invalid: Desta vez, a parte opcional do comando está sendo usada, especificando drive como d, mas os dois pontos foram esquecidos. Lembre-se, 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
Invalid: A opção /p não foi listada na sintaxe do comando, então o comando vol não é executado ao usar isso.
vol c:
Valid: Neste caso, o argumento drive opcional : foi usado como pretendido.
Exemplo 2: Comando de desligamento
A sintaxe listada aqui é para o comando shutdown e é obviamente muito mais complexa do que no exemplo do comando vol acima. No entanto, com base no que você já sabe, há muito pouco mais para aprender aqui:
desligamento [ /i | /l | /s | /r | /g | /a | /p | /h | /e] [ /f] [ /m \\ computername] [ /t xxx] [ /d [ p: | u:] xx: aa] [/c " comentário " ]
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 opções opcionais. Portanto, no exemplo acima, você pode, mas não precisa, optar por incluir uma das seguintes opções ao executar um comando de desligamento: /i, /l , /s, /r, /g, / a, /p, /h, ou /e Como colchetes, existem barras verticais para explicar a sintaxe do comando e não devem ser interpretados literalmente.
O comando shutdown também tem 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 primeiro exemplo, aqui estão algumas maneiras válidas e inválidas de usar o comando shutdown:
desligamento /r /s
Invalid: As opções /r e /s não podem ser usadas juntas. Essas barras verticais indicam opções, das quais você pode escolher apenas uma.
desligamento /s p:0:0
Invalid: Usar /s é perfeitamente adequado, mas o uso de p:0:0não é porque esta opção está disponível apenas com a opção /d , que esquecemos de usar. O uso correto seria shutdown /s /d p:0:0.
desligamento /r /f /t 0
Valid: Todas as opções foram usadas corretamente desta vez. A opção /r não foi usada com nenhuma outra opção dentro de seu conjunto de colchetes, e as opções /f e /topções foram usadas conforme descrito na sintaxe.
Exemplo 3: Comando Net Use
Para nosso exemplo final, vamos ver o comando net use, um dos comandos net. Sua sintaxe é um pouco confusa, então abreviamos abaixo para facilitar a explicação (veja a sintaxe completa aqui):
uso da rede [{ devicename | }] [ nomedocomputador nomedocompartilhamento [{ senha | }] [ /persistente: { 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, separadas por uma ou mais barras verticais, é necessária. Isso é diferente do colchete com barras verticais que indica opções opcionais.
Vejamos alguns usos válidos e inválidos do uso da rede:
net use e:\\server\files
Invalid: O primeiro conjunto de chaves significa que você pode especificar um nome de dispositivo ou usar o caractere curinga - você não pode faz ambos. Ou net use e: \\server\files ou net use\\server\files teriam sido formas válidas de executar net use neste caso.
net use\\appsvr01\source 1lovet0visitcanada /persistent:no
Valid: Usamos corretamente várias opções nesta execução de net use, incluindo uma opção aninhada. Usamos o quando necessário para escolher entre ele e especificar um nome de dispositivo, especificamos um compartilhamento [source] em um servidor [appsvr01] e, em seguida, escolhemos especificar um { password } para isso share, 1lovet0visitcanada, em vez de forçar o net use a nos solicitar um {}. Também decidimos não permitir que esta nova unidade compartilhada seja reconectada automaticamente na próxima vez que iniciarmos o computador [ /persistent:no].
uso líquido /persistente
Invalid: Neste exemplo, optamos por usar a opção /persistent opcional, mas esquecemos de incluir os dois pontos ao lado e também esqueci de escolher entre as duas opções obrigatórias, yes ou no, entre as chaves. Executar net use /persistent:yes teria sido um uso válido de net use.
