Sintaxe de linha de comando (Team Explorer Everywhere)
Este tópico fornece uma sintaxe geral e informações de uso para o Cliente de linha de comando de plataforma híbrida para Team Foundation Server.
Neste tópico
Opções de Especificação
Caminhos absolutos em um computador que esteja executando o Unix sempre se iniciam com uma barra, assim você deve usar hífens para iniciar as opções. Se você não fizer isto, o Cliente de linha de comando de plataforma híbrida para Team Foundation Server não poderá diferenciar um caminho de uma opção. Os exemplos mostrados na documentação para o cliente de linha de comando para Visual Studio usam uma barra para denotar opções, mas para os comandos que são comums a ambos os clientes, você deve usar o hífen (-).
Citando e saindo
Você deve salvar ou citar argumentos para comandos se esses argumentos contêm caracteres que o seu shell considera especiais. Nos sistemas operacionais Windows, geralmente você precisa incluir argumentos entre aspas (“”) apenas se esses argumentos contiverem espaços. As shells Unix têm requisitos adicionais.
Shells Unix
As shells Unix suportam muitos caracteres especiais para curingas, expressões regulares e assim por diante. Você pode marcar o texto literal nos shells do Unix usando um dos três métodos seguintes:
Precede um caractere com uma barra invertida (\) para preservar o valor literal do caractere.
Inclua texto dentro de aspas simples (‘’) para preservar o valor literal dos caracteres inclusos.
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.
Inclua texto dentro de aspas duplos ("") para preservar o valor literal dos caracteres inclusos, com a exceção de $, ', \, e !.
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.
.gif "Observação") Observação |
|---|
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 zah reconhecem que o caractere em um caminho de servidor que ocorre depois que o cifrão não seja 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. |
Exemplos
O exemplo seguinte demonstra como incluir caminhos que contêm espaço em branco em um computador que está executando o Windows.
tf checkout -recursive “$/Inventory/Client Suite/”
O exemplo seguinte demonstra como usar a barra invertida para escapar um caractere simples em um computador executando o Unix.
tf checkout -recursive $/Inventory/Client\ Suite/
O exemplo seguinte demonstra como incluir aspas simples para fechar um caminho em um computador executando o Unix.
tf checkout -recursive ‘$/Inventory/Client Suite/’
O exemplo seguinte demonstra como incluir aspas duplas para fechar um caminho em um computador executando o Unix.
tf checkin -comment:”Fixed the bug\!” file.java
O exemplo seguinte demonstra como usar a barra invertida para escapar cifrões no caminho quando estiver usando o shell csh ou tcsh em um computador executando o Unix.
tf checkout -recursive \$/Inventory/Client\ Suite/
O exemplo seguinte demonstra como usar as aspas simples para fechar cifrões no caminho quando estiver usando o shell csh ou tcsh em um computador executando o Unix.
tf checkout -recursive ‘$/Inventory/Client Suite/’
O exemplo seguinte demonstra como usar as aspas duplas para fechar cifrões no caminho quando estiver usando o shell csh ou tcsh em um computador executando o Unix.
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 |
file.txt;X1067 |
O arquivo previamente excluído com deletionID 1067 |
Especificações de Versão
Uma especificação de versão é uma sequência 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 de dois modos: como sufixos para especificações de item (para obter mais informações, consulte Item Specifications anteriormente neste tópico) e como valores autônomos para a opção /version para certos comandos.
Especificações de versões de exemplo:
Formato de Especificação de Versão |
Descrição |
|---|---|
T |
A Versão Mais Recente |
Cn |
A versão do conjunto de alteração n. |
LlabelID |
A versão de rótulo labelID. |
Wnome; proprietário |
A versão atualmente no espaço de trabalho nome possuído por proprietário. |
Ddatestring |
A versão da data e hora especificada em datestring |
XdeletionID |
A versão que foi excluída e dada ao deletionID pelo servidor. |