Sintaxe de linha de comando (Team Explorer Everywhere)

Artigo
06/10/2015

Você instalou o Cliente de Linha de Comando de Plataforma Híbrida para Team Foundation Server. Mas antes de digitar qualquer comando, você precisará entender a sintaxe geral e as informações de uso.

Neste tópico

Especificando opções

Em computadores UNIX, os caminhos absolutos começam com uma barra (/), portanto você deve usar um hífen (-) para iniciar opções. Caso contrário, o Cliente de Linha de Comando de Plataforma Híbrida para Team Foundation Server não consegue diferenciar um caminho de uma opção.

Citando e saindo

As shells Unix suportam muitos caracteres especiais para caracteres curinga, expressões regulares e assim por diante. Se esses argumentos contêm caracteres que seu shell considera especiais, você precisa salvar ou citar argumentos para comandos. Você pode marcar o texto literal em shells Unix como é mostrado aqui:

Para preservar o valor literal de caracteres, preceda-o com uma barra invertida (\). Por exemplo,
```
tf checkout -recursive $/Inventory/Client\ Suite/
```
Para preservar o valor literal dos caracteres inclusos, inclua texto dentro de aspas simples (''). Variáveis de shell que são referenciadas com um cifrão ($) e curingas não serão expandidos se eles forem incluídos dentro de aspas simples. Por exemplo,
```
tf checkout -recursive ‘$/Inventory/Client Suite/’
```
Para preservar o valor literal dos caracteres inclusos (com exceção de $, ', \ e !), inclua texto dentro de aspas duplas (“").

Por causa destas exceções, as variáveis são expandidas, as subshells ainda são avaliadas, a barra invertida ainda pode ser usada para deletar caracteres e os eventos de histórico ainda são expandidos. O exemplo a seguir mostra que uma barra invertida ainda é necessária para evitar! de ser expandido em um evento de histórico.
```
tf checkin -comment:”Fixed the bug\!” file.java
```

Caminhos de servidor para Visual Studio Team Foundation Server iniciam com um cifrão, mas shells de Unix usam o cifrão para iniciar expansão variável. Shells como sh, ksh, bash e zsh reconhecem que o caractere em um caminho de servidor que ocorre depois do cifrão não é um nome de variável válido. Portanto, estas shells transmitem o cifrão ao Cliente de Linha de Comando de Plataforma Híbrida para Team Foundation Server inalterado.

Porém, as shells derivadas de csh (inclusive tcsh) não analisam a linha de comando desta maneira. Estes shells leem o cifrão e tentaram substituir uma variável que corresponda ao texto que segue. Um erro aparece por que o texto que segue é uma barra (/) e estas shells exigem nomes de variável iniciando com uma letra. Se você usar as shells csh ou tcsh, você deve substituir os cifrões em caminhos de servidor usando uma barra invertida ou aspas simples. As aspas duplas de fazem com que o shell tente expandir a variável. Aqui estão alguns exemplos de escape e citações para shells csh:

tf checkout -recursive \$/Inventory/Client\ Suite/

tf checkout -recursive ‘$/Inventory/Client Suite/’

tf checkout -recursive \$”/Inventory/Client Suite/”

Especificações de item

Uma especificação de item é um local ou caminho de servidor que descreve um arquivo ou pasta que é um parâmetro de entrada para uma opção ou comanda o Cliente de Linha de Comando de Plataforma Híbrida para Team Foundation Server. Uma especificação de item poderia conter um sufixo de especificação de versão, separado por um ponto e vírgula. Esse sufixo é opcional. Especifique o sufixo apenas quando você desejar consultar uma versão histórica de um item.

Especificações de item de exemplo:

Especificação de item	Descrição
$/Inventory/src	Caminho do Servidor para uma pasta
$/Inventory/src/Class.java	Caminho do Servidor para um arquivo
/tmp/Inventory	Caminho local (Unix) para uma pasta de trabalho
/tmp/Inventory/src/Class.java	Caminho local (Unix) para um arquivo
C:\Inventory\src	Caminho local (Windows) para uma pasta de trabalho
C:\Inventory\src\Class.java	Caminho local (Windows) para um arquivo
$/Inventory/src;C4095	Caminho do Servidor para uma pasta no conjunto de alterações 4095
. \ Class.java; C129	Caminho local relativo (Windows) para um arquivo do conjunto de alterações 129
./Class.java; Lrelease-1.0	Caminho local relativo (Unix) para um arquivo rotulado versão-1.0
$/Inventory/src/file.txt; Wdev;john	Caminho do Servidor na versão do espaço de trabalho dev que pertençe a John.
file.txt;D 01/01/2007	Caminho local em 1º de janeiro de 2007 Dica Datas do ISO 8601 são suportadas.Datas são analisadas de acordo com o local do usuário.
file.txt;X1067	O arquivo previamente excluído com deletionID 1067

Especificações de versão

Uma especificação de versão é uma cadeia de caracteres especialmente formatada que recorre a uma única versão específica ou um intervalo de versões de um item em controle de versão. As especificações de versão são usadas em duas maneiras: como sufixos as especificações do item ( Especificações de item consulte anteriormente neste tópico) e como os valores autônomas à opção de -version comando com certeza.

Especificações de versões de exemplo:

Formato de Especificação de Versão	Descrição
T	A Versão Mais Recente
Cn2.0	A versão no conjunto de alterações n.
LlabelID	A versão no rótulo labelID.
Wname; owner	A versão atualmente no espaço de trabalho name de propriedade de owner.
Ddatestring	A versão na data e hora especificadas em datestring
XdeletionID	A versão que foi excluída e deletionID determinada pelo servidor.

Consulte também

Outros recursos

Command-line Reference

Partilhar via