Partilhar via


Sintaxe de linha de comando (em todos os lugares Team Explorer)

Agora você tem instalado Cliente de Linha de Comando de Plataforma Híbrida para Team Foundation Server.Mas antes que você digite qualquer comando, você precisará entender a sintaxe geral e informações de uso.

Neste tópico

Especificando opções

Em computadores de UNIX, o início dos caminhos absolutos com uma barra (/), portanto você usa um hífen (-) para exibir opções.Caso contrário, Cliente de Linha de Comando de Plataforma Híbrida para Team Foundation Server não pode determinar 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 a 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 seguinte exemplo mostra que uma barra invertida ainda é necessária para evitar!de ser expandido em um evento 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 o zsh reconhece que o caractere em um caminho de servidor que ocorre depois que o 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 de fazem com que o shell tente expanda a variável.Aqui estão alguns exemplos escapar e métodos 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

ObservaçãoObservação
Datas ISO 8601 é suportado.Datas são analisada de acordo com a localidade 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 para especificações de item (consulte Item Specifications anteriormente em este tópico) e como valores autônomos a opção de -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.

Consulte também

Outros recursos

Command-line Reference