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

Замечания

Команда workspacestf служебной программы командной строки отображает сведения о рабочих областях на текущем компьютере, принадлежащих указанному пользователю или для всех рабочих областей, связанных с определенным сервером 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