Синтаксис командной строки (Team Explorer Everywhere)

Вы установили Межплатформенный клиент командной строки для Team Foundation Server. Но до того, как ввести любую команду, необходимо понимать общие сведения о синтаксисе и использовании.

В этом разделе

• Установка параметров

• Кавычки и escape-символы

• Спецификации элемента

• Спецификации версии

Установка параметров

На компьютерах UNIX абсолютные пути начинаются с косой черты (/), поэтому для запуска параметров используется дефис (-). В противном случае Межплатформенный клиент командной строки для Team Foundation Server не сможет отличить путь от параметра.

Кавычки и escape-символы

Оболочки Unix поддерживают много специальных знаков для подстановочных знаков, регулярных выражений и т. д. Если эти аргументы содержат символы, которые оболочка считает специальными, необходимо применить escape-последовательность или заключить в кавычки аргументы команд. Можно пометить литералы в оболочках Unix, как показано ниже:

• Чтобы сохранить буквальное значение символа, укажите перед ним обратную косую чертой (\). Например:

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

• Чтобы сохранить буквальные значения заключенных символов, необходимо заключить текст в одинарных кавычках (‘’). Переменные оболочек, ссылка на которые делается со знаком доллара ($), не вычисляются, если заключить их в одиночные кавычки. Например:

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

• Чтобы сохранить буквальное значение заключенных символов (за исключением $, `, \ и !), необходимо заключить текст в двойных кавычках (“”).

  Из-за этих исключений переменные развернуты, подоболочки по-прежнему вычисляются, обратную косую черту можно по-прежнему использовать в escape-символах, а события журнала по-прежнему развернуты. В следующем примере показано, что обратная косая черта все равно необходима, чтобы предотвратить ! от разворачивания в событие журнала.

  tf checkin -comment:”Fixed the bug\!” file.java
  

Серверные пути для Visual Studio Team Foundation Server начинаются со знака доллара, однако в оболочках Unix знак доллара используется для запуска вычисления переменной. Такие оболочки, как sh, ksh, bash и zsh распознает, что символ в серверном пути, который стоит после знака доллара, не является допустимым именем переменной. Поэтому эти оболочки передают знак доллара на Межплатформенный клиент командной строки для Team Foundation Server без изменений.

Однако оболочки, производные от csh (включая tcsh), не анализируют командную строку подобным образом. Эти оболочки считывают знак доллара и делают попытка заменить переменную, которая соответствует тексту, который передается. Поскольку следующий текст представляет собой косую черту (/), и эти оболочки требуют имен переменных начинающихся с буквы, возникает ошибка. При использовании оболочек csh или tcsh необходимо создавать escape-символы для знаков доллара в путях к серверу. Для этого можно использовать обратную косую черту или одиночные кавычки. Двойные кавычки служат причиной попытки развернуть переменную, предпринимаемой оболочкой. Ниже приведено несколько примеров escape-преобразования и заключения в кавычки для оболочек csh:

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

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

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

Спецификации элемента

Спецификация элемента это локальный путь или путь сервера, описывающий файл или папку, представляющие собой входной параметр для опции или команды для Межплатформенный клиент командной строки для Team Foundation Server. Спецификация элемента может содержать суффикс спецификации версии, разделенных точкой с запятой. Этот суффикс является необязательным. Указывайте суффикс, только если нужно сослаться на историческую версию элемента.

Примеры спецификаций элементов:

Спецификации версии

Спецификация версии это специально отформатированная строка, которая указывает на конкретную единую версию или диапазон версий элемента в системе управления версиями. Спецификации версий используются в двух случаях: как суффиксы к спецификациям элементов (см. раздел Спецификации элемента ранее в этом разделе) и как изолированные значения параметра -version для некоторых команд.

Примеры спецификаций версий:

См. также

Другие ресурсы

Command-line Reference