Синтаксис командной строки (Team System)
Обновлен: Ноябрь 2007
Сведения о синтаксисе программы командной строки tf.exe.
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|@commentfile] указывает на то, что можно ввести примечание для набора изменений после параметра /comment: или (|) использовать синтаксис**@**commentfile, чтобы указать путь к файлу, содержащему необходимые примечания. Но указать одновременно параметры 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 разрешает в виде элемента или набора элементов, которые ссылаются на пути в файловой системе или UNC-пути, сопоставленные с рабочей областью или сервером управления версиями.
Для всех команд Team Foundation, принимающих параметр itemspec, можно указывать пути в локальной файловой системе (например, c:\projects), UNC-пути (например, \\myshare\projects) или пути на сервере (например, $/projects/myfiles).
В качестве локальных путей можно указывать относительные пути. Например, если текущим каталогом является каталог c:\projects и необходимо извлечь все элементы во вложенном каталоге этого каталога, можно ввести команду tf checkout .\* /recursive.
.gif "Примечание") Примечание. |
|---|
В командах 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. |
T |
Последняя версия. |
При использовании команды History, Difference или Merge можно указать диапазон версий, разделив значения тильдой (~). В следующих примерах демонстрируется задание диапазона с помощью разделения значения значком тильды.
Просмотр истории файла Form1.cs только для набора изменений 137.
Пример синтаксиса: **tf history /version:**C137~C137
Получение различий между наборами изменений C123 и C125 для файла form.cs.
Пример синтаксиса: tf difference/versionC123~C125 form1.cs.
Слияние всех версий из первого набора изменений до набора изменений C125 в ветвь branch2.
Пример синтаксиса: **tf merge/version:**C125 branch1 branch2.
См. также
Основные понятия
Работа с наборами отложенных изменений системы управления версиями
Работа с наборами изменений системы управления версиями
Ссылки
Другие ресурсы
Справочные сведения о командной строке системы управления версиями Team Foundation