Команда "Рабочие области" (система управления версиями Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Команда система управления версиями Team Foundation (TFVC) workspaces отображает сведения о рабочих областях в системе и обновляет кэшированные сведения об изменении имени пользователя или компьютера на сервере Azure DevOps.
Необходимые компоненты
Чтобы использовать workspaces команду, необходимо задать разрешение на чтение в значение Allow. Дополнительные сведения см. в разделе "Разрешения TFVC по умолчанию".
Синтаксис
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
Параметры
В следующих разделах описываются аргументы и параметры workspaces команды.
Аргументы
Argument
Description
<owner-name>
Предоставляет значение /owner для параметра. Используйте пустую строку ("") для сопоставления рабочих областей, созданных любым пользователем.
<computer-name>
Предоставляет значение /computer для параметра. Используйте пустую строку ("") для сопоставления рабочих областей на любом компьютере.
<workspace-name>
Указывает имя рабочей области для отображения сведений. Если значение не указано, сведения отображаются обо всех рабочих областях на сервере. Вы также можете использовать символ звездочки (*),карта чтобы отобразить сведения обо всех рабочих областях сервера.
<old-user-name>
Предоставляет старое /updateUserName имя пользователя для параметра.
<old-computer-name>
Предоставляет старое /updateComputerName имя компьютера для параметра.
<team-project-collection-url>
URL-адрес коллекции проектов, содержащей рабочие области, о которых требуется отобразить сведения, например https://myserver:8080/tfs/DefaultCollection.
<username>
Предоставляет значение /login для параметра. Это значение можно указать как DOMAIN\<username> или <username>.
<password>
Предоставляет значение /login для параметра.
Параметры
Параметр
Description
/owner
Указывает имя пользователя, создавшего рабочую область. Если владелец не указан, TFVC возвращает сведения о рабочих областях, принадлежащих текущему пользователю.
/computer
Указывает имя клиентского компьютера, с помощью которого необходимо отфильтровать список рабочих областей для сервера. Если компьютер не указан, TFVC возвращает сведения только о рабочих областях на текущем компьютере.
/format
Задает формат сведений о рабочей области. Brief возвращает сведения о рабочей области без сопоставлений. Detailed возвращает сведения о рабочей области, а также сопоставления. Xml возвращает сведения о рабочей области, сопоставление, дату последнего доступа, а также псевдонимы владельца. Подробный формат можно использовать только при указании /collection параметра. По умолчанию устанавливается значение Brief.
/updateUserName
Обновления сведения об идентификации безопасности на сервере Azure DevOps для пользователя, сетевое имя которого было изменено. Если этот параметр указан, необходимо также указать коллекцию проектов /collection с помощью параметра.
/updateComputerName
Указывает TFVC обновить свои таблицы, чтобы отразить изменение имени клиентского компьютера. Если этот параметр указан, необходимо также указать коллекцию проектов /collection с помощью параметра.
/remove
Удаляет указанные записи рабочей области для указанной коллекции проектов из кэша клиента.
/collection
Указывает коллекцию проектов.
/login
Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps Server.
Замечания
Команда workspaces tf служебной программы командной строки отображает сведения о рабочих областях на текущем компьютере, принадлежащих указанному пользователю или для всех рабочих областей, связанных с определенным сервером Azure DevOps. В каждой рабочей области TFVC отображается имя, владелец, комментарий и имя компьютера. С подробными выходными данными также отображаются сопоставления рабочих областей. Если вы не предоставляете фильтр, например имя владельца, компьютера или рабочей области, TFVC отображает только сведения о созданных рабочих областях.
Дополнительные сведения об изменении свойств рабочей области см . в команде "Рабочая область".
Дополнительные сведения об использовании служебной tf программы командной строки см. в разделе "Использование команд управления версиями Team Foundation".
Примеры
В следующем примере отображается список всех рабочих областей для текущего пользователя на текущем компьютере:
c:\projects>tf workspaces
В следующем примере отображается список всех рабочих областей для всех пользователей на всех компьютерах, созданных в следующей коллекции проектов по адресу https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
В следующем примере отображаются подробные сведения обо всех рабочих областях, созданных текущим пользователем в коллекции проектов по адресу https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
В следующем примере отображаются подробные сведения о рабочей области WS1, которая принадлежит текущему пользователю и находится на текущем компьютере. Отображаемые сведения содержат список сопоставлений рабочих областей.
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
В следующем примере удаляются все кэшированные рабочие области из кэша в коллекции проектов по адресу https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection