Команда рабочей области (система управления версиями Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Команда система управления версиями Team Foundation (TFVC) workspace позволяет создавать, удалять, просматривать или изменять свойства и сопоставления, связанные с рабочей областью.
Необходимые компоненты
- Чтобы изменить или удалить существующую рабочую область, необходимо быть владельцем или иметь разрешение глобального Администратор ister workspaces для разрешения.
- Чтобы создать рабочую область, необходимо иметь глобальный набор разрешений для создания рабочей области в значение Allow.
- Чтобы создать рабочие области для других пользователей, необходимо иметь разрешение Администратор ister рабочих областей в значение Allow.
Дополнительные сведения см. в разделе "Разрешения 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 команды.
Аргументы
| Аргумент | Description |
|---|---|
<workspace-name> |
Указывает имя рабочей области, которую вы хотите создать, изменить, удалить или отобразить сведения о ней. |
<workspace-owner> |
Указывает имя пользователя для рабочей области. Этот параметр требуется, если владелец рабочей области не является пользователем, выполняющим команду. |
<computer-name> |
Предоставляет значение /computer для параметра. |
<comment> |
Предоставляет значение /comment для параметра. |
@<comment-file> |
Указывает путь к файлу, в котором должен быть прочитан комментарий. |
<username> |
Предоставляет значение /login для параметра. Это значение можно указать как DOMAIN\<username> или <username>. |
<password> |
Предоставляет значение /login для параметра. |
<team-project-collection-url> |
URL-адрес коллекции проектов, содержащей рабочую область, которую вы хотите создать, изменить, удалить или отобразить сведения, например https://myserver:8080/tfs/DefaultCollection. |
<owner-name> |
Предоставляет значение /newowner для параметра. |
Параметры
| Оператор сравнения | Описание |
|---|---|
/new |
Создает новую рабочую область. |
/template |
Указывает существующую рабочую область, используемую в качестве шаблона для создания новой рабочей области. Новая рабочая область использует сопоставления существующей рабочей области. |
/delete |
Удаляет указанную рабочую область. |
/computer |
Указывает имя компьютера, на котором создается рабочая область. Этот параметр является дополнительным вариантом. |
/comment |
Предоставляет комментарий, описывающий рабочую область. |
/newname |
Переименовывает существующую рабочую область. |
/noprompt |
Выполняет указанную команду рабочей области без отображения диалогового окна. |
/collection |
Указывает коллекцию проектов. |
/permission |
Задает параметры разрешений рабочей области:
Private: только владельцы могут использовать, проверка в файлах или администрировать рабочую область.- Public Limited: любой допустимый пользователь может использовать рабочую область. Но только владельцы могут проверка в файлах или администрировать рабочую область.- Public: любой допустимый пользователь может использовать, проверка в файлах или администрировать рабочую область. |
/location |
Указывает, где создается рабочая область:
local: на клиентском компьютере. Это значение по умолчанию.- server: на сервере Azure DevOps. |
/login |
Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps. |
/newowner |
Указывает имя пользователя для нового владельца рабочей области. |
Замечания
Рабочая область — это локальная копия файлов и папок на сервере, а также любые изменения, внесенные локально. При добавлении, изменении, удалении, перемещении, переименовании или изменении любого элемента, управляемого версией, изменения изолированы в рабочей области, где можно вносить и тестировать изменения. Когда вы проверка в рабочей базе кода команды, зафиксируйте изменения на сервере. Они становятся доступными другим пользователям, которые находятся за пределами рабочей области.
Дополнительные сведения об использовании служебной tf программы командной строки см. в разделе "Использование команд управления версиями Team Foundation".
Создание рабочей области
Прежде чем добавлять файлы на сервер управления версиями или проверка элементов на сервере, необходимо создать рабочую область или связать существующую с текущим каталогом. Дополнительные сведения см. в разделе "Настройка система управления версиями Team Foundation на компьютере разработки".
Чтобы сделать текущий каталог рабочей папкой для существующей рабочей области на компьютере, выполните следующие действия.
- Введите
tf workspace <workspace-name>, где<workspace-name>находится имя существующей рабочей области. Откроется диалоговое окно "Изменить рабочую область ". - Щелкните здесь, чтобы ввести новую рабочую папку.
- В поле "Папка управления версиями" введите путь к серверу, с которым нужно сопоставить текущий каталог.
- В поле "Локальная папка" введите текущий каталог.
- Нажмите ОК.
При создании новой рабочей области можно указать рабочую область шаблона в рамках /new параметра. При указании рабочей области шаблона TFVC создает новую рабочую область на текущем компьютере. TFVC также задает владельца текущему владельцу и реплика отправляет следующие свойства рабочей области в новую рабочую область из рабочей области шаблона: mappings и comment. Если имя не указано, система использует имя, основанное на текущем имени компьютера. При создании рабочей области с помощью шаблона TFVC не извлекает файлы, сопоставленные с сервером. get Используйте команду, чтобы синхронизировать новую рабочую область с последней версией на сервере. Дополнительные сведения см. в разделе "Получение команды".
Сопоставление отдельных папок
Вы можете сопоставить только непосредственные дочерние элементы папки управления версиями с локальной рабочей областью. Для этого добавьте символ звездочки (*) дикий карта в поле папки управления версиями в диалоговом окне "Добавить рабочую область", например$/folder/*. В противном случае все дочерние элементы папки управления версиями рекурсивно сопоставляются с локальной рабочей областью.
Сопоставление отдельных папок в иерархии управления версиями полезно, так как оно ограничивает количество элементов, скачанных на клиентский компьютер. Другим способом ограничения скачанных файлов является маскировка файлов, которые не требуются в рабочей области. Дополнительные сведения см. в статье "Оптимизация рабочей области". Этот подход обеспечивает более быстрое время загрузки и экономит место на клиентском компьютере.
Удаление рабочей области
При удалении рабочей области, содержащей ожидающие изменения, TFVC отменяет ожидающие изменения в процессе удаления. Удаление рабочей области не удаляет файлы и папки на клиентском компьютере, который был в этой рабочей области.
Примечание.
Команды, которые выполняются вручную, требуют /noprompt обхода подтверждения пользователя. Будьте осторожны, если вы используете метод PowerShell Start() для выполнения команд. Параметр /noprompt можно настроить автоматически в PowerShell.
При удалении рабочей области необходимо указать <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 владельцем рабочей области. Для назначения владения новой рабочей областью другому пользователю необходимо разрешение Администратор Workspaces. Дополнительные сведения о разрешениях безопасности см. в разделе "Разрешения 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 , чтобы просмотреть его свойства и сопоставления. Если у вас есть разрешение Администратор Workspaces, можно изменить свойства и сопоставления рабочей области.
c:\projects> tf workspaces Beta1;jenh