Como ler a sintaxe do comando

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 tecnologia em marketing digital 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. , 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.

Chave de sintaxe de comando

A chave de sintaxe a seguir 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
Audacioso	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 conforme mostrado.
Passos	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]	Quaisquer 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 não circundado por 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 . Chaves não devem ser interpretadas literalmente, portanto, não as use ao executar um comando.
Vertical | bar	Barras verticais são usadas para separar itens entre colchetes e chaves. Não tome 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 para usar espaços e outros itens necessários conforme mostrado ao repetir itens.

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.

O vol seguinte é 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 estiver lá não é necessário para o comando funcionar, mas pode ser algo que você deseja usar, dependendo do uso do 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 com vol , já que : está em negrito, deve ser digitado conforme 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ê:

volume

Válido: O comando vol pode ser executado sozinho porque drive : é opcional porque está entre colchetes.

volume

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.

volume: /p

Inválido: A opção /p não foi listada na sintaxe do comando, portanto, o comando vol não é executado ao usá-lo.

volume c:

Válido: Neste caso, o argumento opcional drive : 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 \\ nome do computador ] [ /t xxx ] [ /d [ p: | u: ] xx : yy ] [ /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 . Assim 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 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:

desligar /r /s

Inválido: 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.

desligar /sp:0:0

Inválido: Usar /s está perfeitamente bem, mas o uso de p:0:0 não é porque esta opção está disponível apenas com a opção /d , que esquecemos de usar. O uso correto teria sido shutdown /s /dp:0:0 .

desligar /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 opção dentro de seu conjunto de colchetes, e as opções /f e /t foram usadas conforme descrito na sintaxe.

Exemplo #3: Comando Net Use

Para nosso exemplo final, vejamos 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 de rede [{ devicename | * }] [ \\ nome do computador \ nome do compartilhamento [{ senha | * }]] [ /persistente: { sim | não }] [ /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 suporte com barras verticais que indica opções opcionais .

Vejamos alguns usos válidos e inválidos do uso da rede:

net use e: * \\servidor\arquivos

Inválido: O primeiro conjunto de chaves significa que você pode especificar um nome de dispositivo ou usar o caractere curinga * – você não pode fazer as duas coisas. Ou 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 uso da rede, 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, optamos por especificar um { password } para esse compartilhamento, 1lovet0visitcanada , em vez de forçar o uso de rede a nos solicita 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 ].

uso líquido/persistente

Inválido: neste exemplo, optamos por usar a opção /persistent opcional , mas esquecemos de incluir os dois pontos ao lado e também esquecemos 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.