Команда рабочей области (система управления версиями 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 на компьютере разработки".

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

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

При создании новой рабочей области можно указать рабочую область шаблона в рамках /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