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

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Команда Team Foundation Version Control (TFVC) workspaces отображает сведения о рабочих областях в системе и обновляет кэшированные сведения об изменении имени пользователя или компьютера на сервере Azure DevOps.

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

Категория Требования
Разрешения Разрешение на чтение для параметра 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.

Аргументы

аргумент

описание

<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.

Параметры

параметра

описание

/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
  • Last updated on