Команда Workfold
Создает, изменяет или отображает сведения о связях между папками рабочей области и папками сервера Team Foundation (подсистема контроля версий).
Необходимые разрешения
Для использования команды workfold необходимо быть владельцем указанной или предполагаемой рабочей области или иметь глобальное разрешение Администрирование рабочих областей со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf workfold localfolder [/login:username,[password]]
tf workfold [/workspace:workspacename] [/login:username,[password]]
tf workfold [/collection:TeamProjectCollectionUrl] [/workspace:workspacename] [/login:username,[password]]
serverfolder
tf workfold [/map serverfolder localfolder] [/collection:TeamProjectCollectionUrl]
[/workspace:workspacename][/login:username,[password]
tf workfold /unmap [/collection:TeamProjectCollectionUrl] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder) [/login:username,[password]]
tf workfold /cloak
serverfolder [/workspace:workspacename] [/collection:TeamProjectCollectionUrl] [/login:username,[password]]
tf workfold /decloak serverfolder
[/workspace:workspacename] [/collection:TeamProjectCollectionUrl][/login:username,[password]]
Параметры
Аргумент |
Описание |
|---|---|
имя_рабочей_области |
Задает имя рабочей области, где выполняется команда для параметра /workspace. |
serverfolder |
Задает имя папки сервера Team Foundation (подсистема контроля версий). |
локальная_папка |
Задает имя локальной папки. |
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, содержащей папки, которые необходимо сравнить с папками на сервере (например, http://myserver:8080/tfs/DefaultCollection/). |
имя пользователя |
Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя. |
Параметр |
Описание |
|---|---|
/workspace |
Задает имя рабочей области для работы. |
/map |
Задает связь между локальной папкой и папкой сервера Team Foundation (подсистема контроля версий). По умолчанию команда "workfold" использует данный параметр, даже если он не указан, пока не будут заданы параметры /unmap, /cloak или /decloak. |
/unmap |
Указывает, какое сопоставление папок следует удалить из рабочей области. |
/cloak |
Указывает необходимость исключения папки из действий системы управления версиями, выполняющимися в рабочей области. |
/decloak |
Отменяет маскировку папки для извлечения папки в рабочую область. |
/collection |
Указывает коллекцию командных проектов. |
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
Заметки
Команду 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
См. также
Задачи
Маскировка и отмена маскировки папок в рабочей области
Создание рабочей области и получение файлов
Ссылки
Синтаксис командной строки (управление версиями)
Основные понятия
Создание рабочей области для работы с командным проектом