Команда "рабочие области"

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | VS 2017 | VS 2015 | VS 2013

Отображает сведения о рабочих областях в системе и обновляет кэшированные сведения об изменении имени пользователя или компьютера на сервере, на котором работает Visual Studio Team Foundation Server.

Необходимые разрешения
Чтобы использовать команду " рабочие области ", необходимо иметь разрешенный набор разрешений на Чтение . Дополнительные сведения см. в разделе ссылки на разрешения и группы.

tf workspaces [/owner:ownername] [/computer:computername] 
[/collection:TeamProjectCollectionUrl] [/format:(brief|detailed|xml)] 
[/updateUserName:oldUserName] [/updateComputerName:oldComputerName] 
[workspacename][/login:username,[password]]
tf workspaces /remove:(*|workspace1[,workspace2,...]) 
/collection:(*|TeamProjectCollectionUrl)

Параметры

Аргумент

Описание

ownerName

Предоставляет значение для параметра /owner . Укажите " " , чтобы соответствовать рабочим областям, созданным любым пользователем.

имя_компьютера

Предоставляет значение для параметра /компутер . Укажите " " , чтобы соответствовать рабочим областям на любом компьютере.

workspacename

Указывает имя рабочей области, сведения о которой нужно отобразить. Если workspacename не указан, отображаются сведения обо всех рабочих областях на сервере. Также можно использовать " * " подстановочный знак для вывода сведений обо всех рабочих областях для сервера.

олдусернаме

Предоставляет старое имя пользователя для параметра /упдатеусернаме .

олдкомпутернаме

Предоставляет старое имя компьютера для параметра /updateComputerName .

Url_коллекции_командных_проектов

URL-адрес коллекции проектов, содержащей рабочие области, сведения о которых требуется отобразить (например, http://myserver:8080/tfs/DefaultCollection) .

username

Предоставляет значение для параметра /Login . Можно указать значение username как < > имя пользователя или имя пользователяEM домена.

Параметр

Описание

/Owner

Указывает имя пользователя, создавшего рабочую область. Если владелец не указан, Team Foundation возвращает сведения о рабочих областях, принадлежащих текущему пользователю.

/компутер

Указывает имя клиентского компьютера, по которому будет фильтроваться список рабочих областей для сервера. Если компьютер не указан, Team Foundation возвращает сведения о рабочих областях только на текущем компьютере.

/Format

Задает формат сведений о рабочей области. Brief возвращает сведения о рабочей области без сопоставлений. Подробный результат возвращает сведения о рабочей области, а также сопоставления. XML возвращает сведения о рабочей области, сопоставлении, последнюю дату доступа, а также псевдонимы владельцев. Подробный формат можно использовать только в том случае, если указан параметр /Collection . Brief — это значение по умолчанию.

/упдатеусернаме

Обновляет сведения об идентификации безопасности на сервере Team Foundation Server для пользователя, чье сетевое имя пользователя было изменено. При указании этого параметра необходимо также указать коллекцию проектов с помощью параметра /Collection .

/updateComputerName

Указывает Team Foundation на необходимость обновления таблиц в соответствии с изменением имени клиентского компьютера. При указании этого параметра необходимо также указать коллекцию проектов с помощью параметра /Collection .

/remove

Удаляет указанные записи рабочей области для указанной коллекции проектов из кэша клиента.

/Collection

Указывает коллекцию проектов.

/login

Указывает имя пользователя и пароль для проверки подлинности пользователя с Team Foundation Server.

Комментарии

Команда " рабочие области " программы командной строки tf отображает сведения о рабочих областях на текущем компьютере, принадлежащих указанному пользователю, или обо всех рабочих областях, связанных с конкретным Team Foundation Server. Для каждой рабочей области Team Foundation отображает имя, владельца, комментарий и имя компьютера. С подробным выводом также отображаются сопоставления рабочей области. Если не указать фильтр, например имя владельца, компьютера или рабочей области, то Team Foundation отображает только сведения о созданных рабочих областях.

Дополнительные сведения об изменении свойств рабочей области см. в разделе команда рабочей области.

Дополнительные сведения о том, как найти служебную программу командной строки tf , см. в разделе tf Command-Line Служебные команды.

Примеры

В следующем примере отображается список всех рабочих областей для текущего пользователя на текущем компьютере.

c:\projects>tf workspaces

В следующем примере отображается список всех рабочих областей для всех пользователей на всех компьютерах, которые были созданы в следующей коллекции проектов по адресу http://myserver:8080/tfs/DefaultCollection .

c:\projects>tf workspaces /owner:* /computer:* /collection:http://myserver:8080/tfs/DefaultCollection

В следующем примере отображаются подробные сведения обо всех рабочих областях, созданных текущим пользователем в коллекции проектов по адресу http://myserver:8080/tfs/DefaultCollection .

c:\projects>tf workspaces /computer:* /format:detailed /collection:http://myserver:8080/tfs/DefaultCollection

В следующем примере отображаются подробные сведения, включая список сопоставлений рабочих областей с рабочей областью «WS1», которая принадлежит текущему пользователю и находится на текущем компьютере.

c:\projects>tf workspaces /format:detailed /collection:http://myserver:8080/tfs/DefaultCollection WS1

В следующем примере удаляются все кэшированные рабочие области из кэша в коллекции проектов по адресу http://myserver:8080/tfs/DefaultCollection .

c:\projects>tf workspaces /remove:* /collection:http://myserver:8080/tfs/DefaultCollection

См. также:

Справка

Синтаксис командной строки (управление версиями)
Команда рабочей области
Команда воркфолд

Основные понятия

Создание рабочей области для работы с проектом

Другие ресурсы

Команды служебной программы tf Command-Line
Создание рабочей области и получение файлов в первый раз