Синтаксис командной строки (управление версиями)
Синтаксис tf, программы командной строки Team Foundation, выглядит следующим образом.
tf command item [/options]
В этом разделе описываются соглашения документации, а также сочетания клавиш для вызова команд, специальные символы командной строки, особые параметры Team Foundation, versionspec и itemspec.
Принятые в документации обозначения
[/Brackets] представляют необязательные параметры команд. Элементы без скобок обозначают параметры, которые являются обязательными для выполнения команд. Например, в приведенной ниже команде itemspec является обязательным параметром, а /recursive необязательным.
Пример синтаксиса: c:\projects>tf getitemspec [/recursive]
Реальная команда: c:\projects>tf get c:\projects /recursive
Альтернативная команда: c:\projects>tf get /recursive
В примере альтернативной команды серверу Team Foundation передается информация о том, что пользователю необходимо получить содержимое текущей папки (c:\projects) и всех ее вложенных папок. Поэтому, хотя параметр itemspec и является обязательным, его можно не вводить.
Когда два разделенных символом конвейера (|) и заключены в скобки, можно указать один из этих параметров, но не оба параметра одновременно. Например, tf Changeset [/comment:комментарий|@файл)комментариев] указывает, что можно ввести комментарий для набора_изменений после параметра /comment: или ( |) с помощью синтаксиса **@**файла_примечаний можно указать путь к файлу, содержащему примечание, которое планируется использовать. Но указать одновременно параметры comment и commentfile нельзя.
В примерах синтаксиса курсивом выделены параметры, которые при выполнении команды необходимо заменить фактическими значениями. Полужирным выделены параметры, которые необходимо включать в команды без изменений. Примеры.
Пример синтаксиса: tf shelvesetsshelvesetname [/recursive]
Реальная команда: c:\projects>tf shelvesets BuddyTest_23
Специальные знаки командной строки
Знак «@», также называемый переключателем командного файла, служит для одновременного выполнения набора команд Team Foundation. Основное преимущество использования параметра командной строки в строке, командном файле, пакетном файле и файле скриптов состоит в том, что они будут выполняться быстрее, чем отдельные команды. Дополнительные сведения см. в разделе Параметры командной строки.
Короткие имена и псевдонимы команд
Ниже перечислены короткие имена и псевдонимы команд, поддерживаемых программой командной строки tf.
del = delete
diff = difference
edit = checkout
hist = history
perm = permission
prop = properties
ren = rename
rename = move
stat = status
undel = undelete
Дополнительные сведения о приведенных выше командах см. в разделе Команды служебной программы командной строки "tf".
Обработка элементов Itemspec и Versionspec сервером Team Foundation
Пути Itemspec
Спецификация itemspec, которая является короткой формой спецификации элемента, представляет собой набор из одного или нескольких символов, которые Team Foundation пытается разрешить как адресуемый элемент или набор элементов на компьютере или на сервере управления версиями.
Для всех команд Team Foundation, принимающих параметр itemspec, можно указывать пути в локальной файловой системе (например, c:\projects), UNC-пути (например, \\myshare\projects) или пути на сервере (например, $/projects/myfiles).
В качестве локальных путей можно указывать относительные пути. Например, если текущим каталогом является каталог c:\projects и необходимо извлечь все элементы во вложенном каталоге этого каталога, можно ввести команду tf checkout .\* /recursive.
Совет
В командах Team Foundation (подсистема контроля версий) можно использовать подстановочные знаки, например * и ?.
Если элемент itemspec указывает путь на сервере, это должен быть полный путь. Например, нельзя извлечь все элементы в папке $/projects, указав путь ./*.
Параметр versionspec
Параметр versionspec задает версию элемента, который требуется пользователю. Версию можно указывать с помощью параметра version (например, /version:C1256) или отделяя ее от имени файла точкой с запятой (например, filename;Lmylabel).
Для указания версии используются следующие шаблоны.
Формат указания версии |
Описание |
|---|---|
Набор изменений |
Версия набора изменений с номером changeset. Пример: C1256. |
Llabel |
Версия, связанная с меткой label. Пример: Lmylabel. |
Dгггг-мм-ддTчч:мм либо Dмм/дд/гггг либо Любой формат, поддерживаемый .NET Framework. либо Любой из форматов дат на локальном компьютере. |
Дата и время в любом формате, который может быть обработан методом .NET Framework. Example: D2008-01-21T16:00. Дополнительные сведения о поддерживаемых форматах даты и времени см. в разделе Структура DateTime в библиотеке классов .NET Framework. |
W |
Версия, позже всего загруженная в рабочую область пользователя с помощью команды get. |
Wworkspacename;workspaceowner |
Версия, позже всего загруженная в указанную рабочую область с помощью команды get. Пример: WResolveRIConflicts;AKerry |
T |
Самая последняя версия. |
При использовании команд History или Difference можно указать диапазон версий, разделив значения тильдой (~).
См. также
Ссылки
Основные понятия
Работа с наборами отложенных изменений
Другие ресурсы
Справочные сведения о командной строке системы управления версиями Team Foundation