Команда рабочей области (Управление версиями Team Foundation)

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Команда Управления версиями Team Foundation (TFVC) workspace предоставляет способ создания, удаления, просмотра или изменения свойств и сопоставлений, связанных с рабочей областью.

Необходимые условия

• Чтобы изменить или удалить существующую рабочую область, будьте владельцем или укажите глобальные администрирования рабочих областей, разрешения Разрешить.
• Чтобы создать рабочую область, укажите глобальную создать разрешения рабочей области, чтобы Разрешить.
• Чтобы создать рабочие области для других пользователей, укажите администрирование рабочих областей разрешение разрешить.

Дополнительные сведения см. в разделе разрешения TFVC по умолчанию.

Синтаксис

tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]

tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]

tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]

Параметры

В следующих разделах описаны аргументы и параметры команды workspace.

Аргументы

Параметры

Замечания

рабочей области — это локальная копия файлов и папок на сервере, а также все изменения, внесенные локально. При добавлении, изменении, удалении, перемещении, переименовании или изменении любого элемента, управляемого версией, изменения изолированы в рабочей области, где можно вносить и тестировать изменения. При проверить работу в базе кода команды, вы зафиксируйте изменения на сервере. Они становятся доступными другим пользователям, которые находятся за пределами рабочей области.

Дополнительные сведения об использовании служебной программы командной строки tf см. в разделе Использование команд управления версиями Team Foundation.

Создание рабочей области

Прежде чем добавлять файлы на сервер управления версиями или извлечь элементы на сервере, необходимо создать рабочую область или связать существующую с текущим каталогом. Дополнительные сведения см. в статье Настройка team Foundation Version Control на компьютере разработки.

Чтобы сделать текущий каталог рабочей папкой для существующей рабочей области на компьютере, выполните следующие действия.

1. Введите tf workspace <workspace-name>, где <workspace-name> — имя существующей рабочей области. Откроется диалоговое окно "Изменить рабочую область ".
2. Выберите щелкните здесь, чтобы ввести новую рабочую папку.
3. В поле папки управления версиями введите путь к серверу, с которым вы хотите сопоставить текущий каталог.
4. В поле локальная папка введите текущий каталог.
5. Нажмите кнопку ОК.

При создании новой рабочей области можно указать рабочую область шаблона в рамках параметра /new. При указании рабочей области шаблона TFVC создает новую рабочую область на текущем компьютере. TFVC также задает владельца текущему владельцу и реплицирует следующие свойства рабочей области в новую рабочую область из рабочей области шаблона: mappings и comment. Если имя не указано, система использует имя, основанное на текущем имени компьютера. При создании рабочей области с помощью шаблона TFVC не извлекает файлы, сопоставленные с сервером. Используйте команду get для синхронизации новой рабочей области с последней версией на сервере. Дополнительные сведения см. в команде Get.

Сопоставление отдельных папок

Вы можете сопоставить только непосредственные дочерние элементы папки управления версиями с локальной рабочей областью. Для этого добавьте подстановочный знак звездочки (*) в поле папку управления версиями в диалоговом окне Добавление рабочей области, например $/folder/*. В противном случае все дочерние элементы папки управления версиями рекурсивно сопоставляются с локальной рабочей областью.

Сопоставление отдельных папок в иерархии управления версиями полезно, так как оно ограничивает количество элементов, скачанных на клиентский компьютер. Другим способом ограничения скачанных файлов является маскировка файлов, которые не требуются в рабочей области. Дополнительные сведения см. в статье Оптимизациярабочей области. Этот подход обеспечивает более быстрое время загрузки и экономит место на клиентском компьютере.

Удаление рабочей области

При удалении рабочей области, содержащей ожидающие изменения, TFVC отменяет ожидающие изменения в процессе удаления. Удаление рабочей области не удаляет файлы и папки на клиентском компьютере, который был в этой рабочей области.

При удалении рабочей области необходимо предоставить <workspace-owner> и <workspace-name>

Для получения этих значений можно использовать команду workspace. Дополнительные сведения см. вкоманд рабочих областей. Чтобы найти значение <workspace-owner>, выполните следующую команду:

c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml

Чтобы найти значение <workspace-name>, используйте значение <OwnerId> из выходных данных предыдущей команды в качестве значения <workspace-owner>. Это значение имеет формат идентификатора объекта Azure Active Directory (Azure AD), за которым следует обратная косая черта и имя участника-пользователя. Используйте все значение. Затем выполните следующую команду:

c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`

Чтобы удалить рабочую область, выполните следующую команду:

c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`

Изменение рабочей области

Вы можете изменить следующие атрибуты рабочей области:

• Имя рабочей области
• Комментарий
• Сопоставления рабочих папок

Если спецификация рабочей области не указана, используется рабочая область для текущей папки.

Примеры

В следующем примере откроется диалоговое окно Добавление рабочей области и создание новой рабочей области. Диалоговое окно Добавление рабочей области можно использовать для изменения папки управления версиями, владельца, компьютера, комментария и локальных папок.

c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection

В следующем примере создается новая рабочая область с именем Beta1 и назначается jenh в качестве владельца рабочей области. У AdminWorkspaces разрешение на назначение владения новой рабочей областью другому пользователю. Дополнительные сведения о разрешениях безопасности см. в разделе разрешения TFVC по умолчанию.

c:\projects>tf workspace /new Beta1;jenh

В следующем примере создается новая рабочая область с помощью рабочей области Beta1, принадлежащей jenh в качестве шаблона:

c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection

В следующем примере удаляется рабочая область Beta1 с сервера:

c:\projects>tf workspace /delete Beta1

В следующем примере свойства для текущей рабочей области редактируются:

c:\projects>tf workspace

В следующем примере открывается рабочая область Beta1, принадлежащую jenh, чтобы просмотреть его свойства и сопоставления. Если у вас есть разрешение AdminWorkspaces, можно изменить свойства и сопоставления рабочей области.

c:\projects> tf workspaces Beta1;jenh

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

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