Команда "workfold"
Обновлен: Ноябрь 2007
Создает, изменяет или отображает сведения о связях между папками рабочей области и папками сервера Team Foundation (подсистема контроля версий).
Требуемые разрешения
Для использования команды workfold необходимо быть владельцем указанной или предполагаемой рабочей области или иметь глобальное разрешение Администрирование рабочих областей со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf workfold localfolder
tf workfold [/workspace:workspacename]
tf workfold [/server:servername] [/workspace:workspacename]
serverfolder
tf workfold [/map serverfolder localfolder] [/server:servername]
[/workspace:workspacename] (serverfolder|localfolder)
tf workfold /unmap [/server:servername] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder)
tf workfold /cloak
(serverfolder|localfolder) [/workspace:workspacename] [/s:servername]
tf workfold /decloak (serverfolder|localfolder)
[/workspace:workspacename] [/s:servername]
Параметры
Аргумент |
Описание |
|---|---|
имя_сервера |
Задает имя сервера Team Foundation для параметра /server. Пример: "teamfoundation2". |
имя_рабочей_области |
Задает имя рабочей области, где выполняется команда для параметра /workspace. |
serverfolder |
Задает имя папки сервера Team Foundation (подсистема контроля версий). |
локальная_папка |
Задает имя локальной папки. |
Параметр |
Описание |
|---|---|
/server |
Определяет Team Foundation Server. Этот параметр является обязательным, если вызов команды осуществляется из каталога, который не сопоставлен рабочей области. |
/workspace |
Задает имя рабочей области для работы. |
/map |
Задает связь между локальной папкой и папкой сервера Team Foundation (подсистема контроля версий). По умолчанию команда "workfold" использует данный параметр, даже если он не указан, пока не будут заданы параметры /unmap, /cloak или /decloak. |
/unmap |
Указывает, какое сопоставление папок следует удалить из рабочей области. |
/cloak |
Указывает необходимость исключения папки из действий системы управления версиями, выполняющимися в рабочей области. |
/decloak |
Отменяет маскировку папки для извлечения папки в рабочую область. |
Заметки
Команду workfold программы командной строки tf можно использовать для создания и изменения сопоставлений рабочих областей. При сопоставлении рабочих областей создается папка на стороне клиента, в которую при выполнении операции tf get извлекаются все файлы и вложенные папки из папки сервера Team Foundation (подсистема контроля версий). Если папка на стороне клиента замаскирована, операция get работать не будет.
Для сопоставления папки Team Foundation Server и ее элементов локальной рабочей области также можно указать подстановочный знак "звездочка" (*). Это часто называется сопоставлением одной папки.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Параметры для сопоставления рабочей области
Сопоставление рабочей области представляет собой список активных и замаскированных элементов. С помощью параметра /map элементы сервера Team Foundation (подсистема контроля версий) можно добавить в сопоставленный список в рабочей области. Кроме того, с помощью параметра /cloak можно явным образом исключить элемент из рабочей области. Замаскировать можно только элементы, имеющие родительские объекты. Маскировка является эффективным способом повышения скорости выполнения пакетных операций Get и сохранения места на диске.
Используйте маскировку в случае необходимости. Во избежание проблем, связанных с компиляцией и интегрированием, для маскировки следует выбирать только те элементы, которые будут находиться вне области действия текущих и будущих проектов, например изображения и внешние файлы документации.
Для выборочного удаления сопоставленных и замаскированных элементов из сопоставления рабочей области воспользуйтесь параметрами /unmap и /decloak.
Применение сопоставлений рабочих областей
По умолчанию сопоставления рабочих областей применяются рекурсивно. При сопоставлении локальной папки папке сервера Team Foundation (подсистема контроля версий) система неявным образом создает сопоставление между всеми ее текущими и будущими вложенными папками. Например, при сопоставлении $/projects и c:\projects, после чего добавляется проект с именем "$/projects/project_one", а затем выполняется get рабочей области, Team Foundation автоматически создает в каталоге C:\projects локальную рабочую папку с именем "project_one".
В этом примере для сопоставления папки сервера и ее непосредственных элементов с локальной рабочей областью используется подстановочный знак "*".
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
В этом примере для переопределения автоматически созданного сопоставления $/projects/project_one и C:\projects\project_one используется команда workfold.
tf workfold $/projects/project_one C:\DifferentWorkfold
Сопоставление с маскировкой
Сопоставления незамаскированных папок, расположенных в иерархии управления версиями под замаскированными папками, могут быть сопоставлены локальной рабочей области.
Примеры
В следующем примере отображаются сопоставления для рабочей области, где находится папка c:\projects.
c:\projects>tf workfold
В следующем примере выполняется маскирование папки c:\projects\lib.
c:\projects>tf workfold /cloak c:\projects\lib
В следующем примере отображается сопоставление для локального файла word.cs.
c:\projects>tf workfold word.cs
В следующем примере папка C:\DifferentWorkfold сопоставляется папке сервера Team Foundation (подсистема контроля версий) $/projects/project_one; заменяется предыдущее сопоставление рабочей области для папки сервера Team Foundation (подсистема контроля версий) $/projects/project_one.
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold
См. также
Задачи
Пошаговое руководство. Управление версиями в Team Foundation с помощью командной строки
Практическое руководство. Маскировка и отмена маскировки папок в рабочей области
Практическое руководство. Создание сопоставленной рабочей области
Основные понятия
Работа с рабочими областями системы управления версиями
Ссылки
Синтаксис командной строки (Team System)