Поделиться через


Команда 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 при выполнении 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