Команда 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 команды.

Аргументы

Параметры

Замечания

Вы можете использовать workfold команду служебной программы командной tf строки для создания и редактирования сопоставлений рабочих областей. Сопоставление рабочей области создает клиентская папка, в которую извлекаются все файлы и вложенные папки в папке сервера Azure DevOps при выполнении tf get операции. Операция 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

Связанные статьи

• Оптимизация рабочей области
• Использование команд управления версиями Team Foundation
• Команда рабочей области
• Создание и работа с рабочими областями
• Настройка система управления версиями Team Foundation на компьютере разработки