Справочные сведения о командах Team Foundation (подсистема контроля версий)
Для команд управления версиями можно использовать практически все задачи можно вносить в Visual Studio а также несколько задач, которые не удается выполнить в Visual Studio.Можно использовать программу tf.exe для запуска команды управления версиями из командной строки или в скрипте.
Выполняемые задачи
Выполните команду
Настройте компьютер dev
Разработайте приложение
Приостановка работы
Участие работу
Управление файлами и разрешение проблем
Выявление риск
Понимание синтаксис команды
Определение элементов, затронутые командой
Используйте аргумент itemspec для определения указанные элементы
Используйте аргумент версию файла для определения указанные версии элементов
Используйте параметры способ функции команды
Используйте параметр /noprompt отключить запросы для ввода данных и настройка данные об объеме продукта в окне командной строки
Параметр /login позволяет задать учетные данные, команда
Используйте параметр /lock применить или удалить блокировку
Используйте ярлыки параметра
Анализ кода завершения
Выполните команду
Запустить командную строку Visual Studio, из Windows Запуск выберите Microsoft Visual Studio 2012, Средства Visual Studio Tools, а затем выберите один из ярлыков Окно командной строки.
В большинстве случаев при выполнении команды управления версиями в контексте каталога, отображаемым в рабочей области.Например, $/SiteApp/Main/ соответствует c:\code\SiteApp\Main\.Получение последней версии всех элементов в рабочей области.
c:\code\SiteApp\Main\SolutionA>tf get
Примечание |
---|
Рекомендуется в настоящее время не переиздаем некоторых разделов.Однако можно считать версии Visual Studio 2010 этих разделов. |
Настройте компьютер dev и управлять рабочие области
Рабочую область локальную копию базы кода команды.Поскольку локальную копию на компьютере dev, можно разрабатывать и выполните код в изоляции до тех пор, пока не будет готово вернуть работу.Ниже приведены некоторые команды управления рабочую область.
Proxy Command (Visual Studio 2010)
WorkFold Command (Visual Studio 2010)
Workspace Command (Visual Studio 2010)
Workspaces Command (Visual Studio 2010)
См. также: Настройка компьютера разработки и запуск системы с использованием модуля управления версиями, Управление рабочими областями
Разработайте приложение
Эти команды разработку приложения в системе управления версиями с другими участниками команды.
Команда Add
Добавляет файлы и папки в систему управления версиями.Команда "Извлечь" (или "Правка")
Извлекает файл и изменяет состояние ожидающих изменений в "правке".Команда Delete (управление версиями в Team Foundation) (Visual Studio 2010)
Команда Get
Получает (загружает) или определенную самую последнюю версию одного или нескольких файлов и папок из Team Foundation Server в рабочей области.Команда Rename (управление версиями Team Foundation) (Visual Studio 2010)
Команда Status
Отображающий данные об ожидающих изменениях в файлах и элементам папок в одном или нескольких рабочих областях, или в наборе отложенных изменений.Команда undo
Отменяет одну или несколько ожидающие изменения в файлы и папки.Undelete Command (Visual Studio 2010)
См. также: Разработка приложения в базе кода, расположенной в системе управления версиями
Приостановка работы
По различным причинам, иногда необходимо кэшировать отложить некоторых или всех из вашего незавершенного производства.Приостановить и возобновить работу и управлять отложенные изменения, используются следующие команды:
Команда Shelve (Visual Studio 2010)
Shelvesets Command (Visual Studio 2010)
Команда Unshelve (Visual Studio 2010)
См. также: Приостановка работы и управление наборами отложенных изменений.
Участие работу
Описание вернуть код в базу кода команды:
- Команда "Возврат"
Вернуть ожидающие изменения в файлы или папки на сервере.
См. также: Возврат работы в базу кода команды
Управление файлами и разрешение проблем
Просмотр и управление файлов и папок системы управления версиями
Команда Properties (Visual Studio 2010)
Команда Property (недокументированная)
Dir Command (Visual Studio 2010)
Destroy Command (Visual Studio 2010)
LocalVersions Command (Visual Studio 2010)
Просмотр и управление последние версии
Changeset Command (Visual Studio 2010)
Команда History
Отображает журнал изменений одного или нескольких файлов или папок.Label Command (Visual Studio 2010)
Labels Command (Visual Studio 2010)
Rollback Command (Visual Studio 2010)
Unlabel Command (Visual Studio 2010)
View Command (Visual Studio 2010)
См. также: Просмотр прошлых версий и управление ими
Сравнение папок и файлов
Difference Command (Visual Studio 2010)
Folderdiff Command (Visual Studio 2010)
См. также: Просмотр прошлых версий и управление ими
Разрешение конфликтов файла
Resolve Command (Visual Studio 2010)См. также: Разрешение конфликтов файлов.
Работа с системой управления версиями блокирует
Lock Command (Visual Studio 2010)См. также: Работа с блокировками системы управления версиями.
Выявление риск
Используйте следующие команды определить риск с помощью ветви:
Branch Command (Visual Studio 2010)
Branches Command (Visual Studio 2010)
Merge Command (Visual Studio 2010)
Merges Command (Visual Studio 2010)
См. также: Изолирование риска с помощью ветвей.
Управление системой управления версиями
Используйте следующие команды администрирование системой управления версиями.
Configure Command (Visual Studio 2010)
Permission Command (Visual Studio 2010)
См. также: Администрирование системы управления версиями Team Foundation (Visual Studio 2010).
Помощь в командах управления версиями
Используйте следующие команды получить дополнительные сведения о командах управления версиями.
Help Command (Visual Studio 2010)
Msdn Command (Visual Studio 2010)
Понимание синтаксис команды
Синтаксис каждой команды отображается в верхней части каждый раздел справки.
Обязательный и необязательные аргументы
, введенных в скобки аргументы не требуются.[Brackets] указывает необязательные аргументы, необходимых для завершения команды.Однако некоторые необязательные аргументы имеют по умолчанию, которые применяются к команде даже в том случае, если не задан параметр.
Монопольные аргументы
Если параметры разделены каналу (|), можно указать один из следующих параметров.
Дословные и меняемые аргументы
Полужирным выделены параметры, которые необходимо включать в команды без изменений.элементы Выделенные курсивом аргументы, которые необходимо заменить на реальные знаков для выполнения команды.
Короткие имена и псевдонимы команд
Некоторые команды поддерживают ярлыки.Например, можно вызвать Команда удаления с tf delete или tf del.
Пример
Например, Команда извлечения:
tf checkout [/lock:( none|checkin|checkout)] [/recursive] itemspec [/login: username,[ password]]
Рассмотрим следующий просмотреть аргументы из этого примера:
itemspec: Необходимо заменить этот аргумент с itemspec, который определяет элементы, таким образом.
/lock:(none|checkin|checkout): Не требуется указать параметр /lock.Если не указать его, то система определяет по умолчанию /lock:none.В противном случае можно указать один из параметров блокировки.
Следующие аргументы являются необязательными и если их не указывается, ни один из этих эффектов применяются к команде.
/recursive: Если требуется получить несколько рекурсивно элементы в папке, необходимо указать этот параметр ключевое слово в ключевое слово.
/login:имя пользователяпароль,: Если требуется выполнить команду другой пользователь, необходимо задать параметр /login ключевое слово в ключевое слово, замените имя пользователя именем пользователя и при необходимости, укажите пароль.
Определение элементов, затронутые командой
Можно itemspecs и versionspecs позволяют указать, какие элементы затронутых командой.
Используйте аргумент itemspec для определения указанные элементы
Используется спецификацию элемента ( itemspec ) для указания элементов, затронутые командой.Можно задать элементы или на клиентском компьютере или на сервере Team Foundation Server.Можно использовать подстановочные знаки, такие как * и ?.
Аргументы itemspec клиента
Аргумент itemspec клиента определяет путь к элементам на клиентском компьютере, например папка (например, c:\code\SiteApp\Main\SolutionA\) - (например, c:\code\SiteApp\Main\SolutionA\Project1\program.cs или несколько файлов (например, c:\code\SiteApp\Main\SolutionA\*.cs.Можно также указать UNC-пути, например \\myshare\code\SiteApp\Main.
Аргументы itemspec сервера
Аргумент itemspec сервера определяет путь к элементам на сервере Team Foundation Server, например папка (например, $/SiteApp/Main/SolutionA) - (например, $/SiteApp/Main/SolutionA/Project1/program.cs или несколько файлов (например, $/SiteApp/Main/SolutionA/*.cs.
Обычно используются аргументы itemspec сервера, когда требуется выполнить команду для элементов не на клиентском компьютере.Например, для работы на компьютере dev и необходимо получить некоторые данные журнала изменений об определенных элементов, находящихся в коллекции командных проектов, не работает в:
c:\>tf history /collection:http://fabrikam-3:8080/tfs/DefaultCollection
$/SiteApp/Main/SolutionA/Project1/* /recursive
/noprompt
Несколько аргументов itemspec
Для некоторых команд можно определить несколько аргументов itemspec.Например:
c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c
Извлекает program.cs и program2. C.
Используйте аргумент версию файла для определения указанные версии элементов
Используется versionspec (версию спецификации), чтобы определить версию элементов, затронутых командой.Можно задать значение свойства versionspec.
Использовать параметр /version.Например, /version:C44.
Добавьте версию файла в itemspec точкой с запятой.Например, program1.cs;C44.
При использовании Команда History или Difference Command, можно указать диапазон версий, разделяя версии с тильдой (|).Например:
c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012
Используйте следующий синтаксис для указания versionspec.
Тип |
Синтаксис |
Описание |
---|---|---|
Набор изменений |
[C]n |
Определяет элементы на основании номер набора изменений.Если элемент, в области не был изменен в определенном наборе изменений, система получает последнюю версию элемента, произошедшего перед указанным набором изменений.
Совет
Можно опустить C следует задавать только числа.
Примеры
- или -
- или -
Если readme.txt было изменено в наборе изменений 8, получает эту версию файла.В противном случае возвращает последней версии readme.txt до версии 8. |
Метка |
Llabel |
Определяет элементы, к которым применялись label. Примеры
Получает версию readme.txt, которая была помечена JulyHotFix.
Возвращает версию всех меткаых элементов (и удаляет эти элементы не помеченные) в рабочей области по состоянию, когда набор изменений с подписью как LastKnownGood был создан, например, возможно как часть автоматизированного процесса построения. |
Дата и время |
Dyyyy-mm-ddTxx:xx —или— Dmm/dd/yyyy —или— Любой формат, поддерживаемый .NET Framework. —или— Все форматы даты, поддерживаемые на локальном компьютере. |
Определяет набора изменений для определенной даты и времени. Примеры
Обновляет рабочую область, чтобы соответствовать базе кода, как она входит в 3/22/2004 в 00:00 (полночь).
Обновляет рабочую область, чтобы соответствовать базе кода, как она существовала в 3/22/2004 в 09:00 AM (9). Дополнительные сведения о платформы .NET Framework поддерживает форматы даты и времени см. в разделе DateTime и Строки стандартных форматов даты и времени. |
Рабочая область текущего () |
W |
Указывает версию в локальной рабочей области. |
Конкретная рабочая область () |
Wworkspacename; workspaceowner |
Указывает версию в конкретной рабочей области. Пример: WResolveRIConflicts;PeterW |
Совет. |
T |
Определяет последней версии. |
Используйте параметры способ функции команды
Можно использовать некоторые общие параметры способ функции команды.
Используйте параметр /noprompt отключить запросы для ввода данных и настройка данные об объеме продукта в окне командной строки
Используйте параметр /noprompt отключить запросы для ввода данных и настройка данные об объеме продукта в окне командной строки.Этот параметр может быть полезен, если необходимо использовать команды управления версиями в скрипте, поскольку команда продолжается без вмешательства пользователя, и данные предоставляются для скрипта выполнять операции, например или для анализа.
При использовании этого параметра, система:
Отключает все запросы для ввода:
Вопросы не запрошены в окне командной строки.Например, при использовании Команда undo с этим параметром, система не запрос на подтверждение, если требуется продолжить откатить изменения.
Windows и диалоговые окна не приводятся.Например, этот параметр можно использовать с Команда "Возврат".Вместо отображения диалогового окна Вернуть для подтверждения параметры (элементы, которые необходимо вернуть или рабочие элементы, которые требуется связать), система продолжается с вернуть без подтверждения.
Перенаправляет данные об объеме продукта в командной строке.Например, этот параметр можно использовать с Команда History.Данные отображаются в окне командной строки вместо Окно " Журнал ".
Параметр /login позволяет задать учетные данные, команда
Используйте параметр /login, чтобы указать учетную запись пользователя Team Foundation Server для запуска команды.Этот параметр может быть полезен при работе на компьютере другого участника команды.
Например, юлия работает с Питером dev его на компьютере.Она использует Команда блокировки, чтобы пропустить файла, она блокировала ранее:
c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI,JuliaPassword
Если она не будет иметь свой пароль, отобразятся в командную строку, она может ввести команду без пароля.
c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI
После того, как она входит эта команда, система затем запрашивает ее ее ввести пароль в диалоговом окне, ее маски ввода.
Используйте параметр /lock применить или удалить блокировку
Важно |
---|
Как правило, используйте параметр /lock с осторожностью и сообщайте свои товарищей по команде причин, по которым необходимо блокируете элемент, и когда планируется удалить блокировку. |
Параметр /lock применяется или удалить блокировку одновременно выполняется другая команда, например Добавьте или Правка.
/lock:(none|checkin|checkout)
None: элемент не заблокирован.Уже имеющаяся блокировка отменяется.
Checkin или Checkout: применяет блокировку.Дополнительные сведения см. в разделе Основные сведения о типах блокировки.
Примечание |
---|
В немногих случаях операция блокирования может завершиться ошибкой.
|
Используйте ярлыки параметра
Можно сократить следующие параметры.
Параметр |
Краткая форма параметра |
---|---|
/comment |
-C |
/computer |
-M |
/delete |
-D |
/force |
-P |
/format |
-F |
/help |
-?, -H |
/lock |
-K |
/login |
-Y |
/newname |
-N |
/noprompt |
-I |
/owner |
-O |
/recursive |
-R |
/server |
-S |
/slotmode |
-X |
/template |
-T |
/user |
-U |
/version |
-V |
/workspace |
-W |
Анализ кода завершения
Команды управления версиями возвращают следующие коды завершения.
Код выхода |
Определение |
---|---|
0 |
Успех. |
1 |
Частичный успех. Это значит, что по крайней мере часть задач (или все задачи) выполнить не удалось. |
2 |
Неизвестная команда. |
100 |
Неудача. |
Например:
c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c
Если один из файлов попытке извлечь на сервере не существует, команда возвращает значение 1, указывающее, частично успех.