Команда workfold (система управления версиями Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Команда система управления версиями Team Foundation (TFVC) workfold создает, изменяет или отображает сведения о сопоставлениях между папками рабочей области и папками, которые находятся на сервере Azure DevOps для TFVC.
Необходимые компоненты
Чтобы использовать команду workfold, следует быть владельцем указанной или подразумеваемой рабочей области или иметь глобальные администрирования рабочих областей разрешение на Allow. Дополнительные сведения см. в разделе "Разрешения TFVC по умолчанию".
Синтаксис
tf workfold <local-folder> [/login:<username>,[<password>]]
tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]
tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>
tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>]
[/workspace:<workspace-name>][/login:<username>,[<password>]
tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>]
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]
tf workfold /cloak
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]
tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]
Параметры
В следующих разделах описываются аргументы и параметры workfold команды.
Аргументы
Argument
Description
<workspace-name>
Указывает имя рабочей области, с которой работает /workspace команда.
<server-folder>
Указывает имя папки сервера Azure DevOps.
<local-folder>
Указывает имя локальной папки.
<team-project-collection-url>
URL-адрес коллекции проектов, содержащей папки, которые необходимо сравнить с папками сервера, например https://myserver:8080/tfs/DefaultCollection/.
<username>
Предоставляет значение /login для параметра. Это значение можно указать как DOMAIN\<username> или <username>.
<password>
Предоставляет значение /login для параметра.
Параметры
Параметр
Description
/workspace
Указывает имя рабочей области для работы.
/map
Указывает связь между локальной папкой и папкой сервера Azure DevOps. По умолчанию workfold команда использует этот параметр, даже если /unmap/cloak/decloak не указано или не указано.
/unmap
Указывает сопоставление папок для удаления из рабочей области.
/cloak
Указывает, что папка должна быть исключена из любых действий управления версиями, выполненных в рабочей области.
/decloak
Удаляет папку, чтобы ее можно было извлечь в рабочую область.
/collection
Указывает коллекцию проектов.
/login
Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps.
Замечания
Вы можете использовать workfold команду служебной программы командной tf строки для создания и редактирования сопоставлений рабочих областей. Сопоставление рабочей области создает клиентская папка, в которую извлекаются все файлы и вложенные папки в папке сервера Azure DevOps при выполнении tfget операции. Операция get не работает, если клиентская папка закрыта.
Вы также можете использовать подстановочный знак звездочки (*) для сопоставления папки Azure DevOps Server и его непосредственных элементов с локальной рабочей областью. Это сопоставление часто называется сопоставлением одной папки.
Дополнительные сведения об использовании служебной tf программы командной строки см. в разделе "Использование команд управления версиями Team Foundation".
Параметры сопоставления рабочих областей
Сопоставление рабочей области — это список активных и закрытых элементов. Вы можете добавить элементы сервера Azure DevOps в сопоставленный список в рабочей области с помощью /map параметра. Вы также можете исключить элемент из рабочей области явным образом с помощью /cloak параметра. Вы можете закрыть только элементы, имеющие сопоставленный родительский элемент. Маскировка — это эффективный способ повышения скорости пакетных get операций и экономии места на диске.
Используйте маскировку по усмотрению. Чтобы избежать проблем с компиляцией и интеграцией, следует только закрывать те элементы, которые вы знаете, вне области текущих и будущих проектов, таких как изображения и внешние файлы документации.
Вы можете использовать /unmap параметры и /decloak параметры для выборочного удаления сопоставленных и закрытых записей из сопоставления рабочей области.
Применение сопоставлений рабочих областей
По умолчанию сопоставления рабочих областей применяются рекурсивно. При сопоставлении локальной папки с папкой сервера Azure DevOps система неявно создает сопоставление между всеми текущими и будущими вложенными папками.
Например, предположим, что вы сопоставляете $/projects с C:\projects. Затем вы добавите проект с именем $/projects/project_one, а затем выполните get команду в рабочей области. В этом сценарии TFVC автоматически создает локальную рабочую папку с именем project_one в каталоге C:\projects .
В следующем примере используется подстановочный знак звездочки (*) для сопоставления папки сервера и его непосредственных элементов с локальной рабочей областью:
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
В следующем примере команда используется workfold для переопределения сопоставления, которое автоматически создается между $/projects/project_one и C:\projects\project_one:
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 сопоставляется с папкой сервера Azure DevOps $/projects/project_one и заменяет предыдущее сопоставление рабочих областей для папки сервера $/projects/project_one сервера Azure DevOps:
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold