Команда Workspaces
Отображает сведения о рабочих областях в системе и обновляет кэшированные данные об изменении имени пользователя или имени компьютера на сервере под управлением Visual Studio Team Foundation Server.
Необходимые разрешения
Для использования команды workspaces необходимо иметь разрешение Чтение со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf workspaces [/owner:ownername] [/computer:computername]
[/collection:TeamProjectCollectionUrl] [/format:(brief|detailed)]
[/updateUserName:oldUserName] [/updateComputerName:oldComputerName]
[workspacename][/login:username,[password]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|TeamProjectCollectionUrl)
Параметры
Аргумент |
Описание |
|---|---|
ownername |
Предоставляет значение для параметра /owner. Укажите "*" для поиска рабочих областей, созданных пользователями. |
computername |
Предоставляет значение для параметра /computer . Укажите "*" для поиска рабочих областей на любом компьютере. |
workspacename |
Задает имя рабочей области, сведения о которой нужно отобразить. Если аргумент workspacename не указан, выводятся сведения обо всех рабочих областях на сервере. Для отображения сведений обо всех рабочих областях сервера можно использовать подстановочный знак "*". |
oldUserName |
Предоставляет старое имя пользователя для параметра /updateUserName. |
oldComputerName |
Представляет старое имя компьютера для параметра /updateComputerName. |
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, содержащей рабочие области, о которых необходимо отобразить информацию (например, http://myserver:8080/tfs/DefaultCollection). |
username |
Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя. |
Параметр |
Описание |
|---|---|
/owner |
Указывает имя пользователя, создавшего рабочую область. Если имя автора не указано, Team Foundation возвращает сведения о рабочих областях, принадлежащих только текущему пользователю. |
/computer |
Задает имя клиентского компьютера, по которому будет выполнена фильтрация списка рабочих областей для сервера. Если компьютер не указан, Team Foundation возвращает сведения о рабочих областях только текущего компьютера. |
/format |
Задает формат отображения сведений о рабочей области. Brief возвращает сведения о рабочей области без сопоставлений. Detailed возвращает сведения о рабочей области и сопоставления. Подробный формат используется только при указании параметра /collection . Brief является значением по умолчанию. |
/updateUserName |
Обновляет данные об идентификаторах безопасности на сервере Team Foundation для пользователя, сетевое имя которого было изменено. Если указан данный параметр, также необходимо указать коллекцию командного проекта с помощь параметра /collection. |
/updateComputerName |
Указывает Team Foundation обновить таблицы для отражения изменения имени клиентского компьютера. Если указан данный параметр, также необходимо указать коллекцию командного проекта с помощь параметра /collection. |
/remove |
Удаляет записи указанных рабочих областей для указанной коллекции командного проекта из кэша клиента. |
/collection |
Указывает коллекцию командных проектов. |
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Team Foundation Server. |
Заметки
Команда workspaces программы командной строки tf отображает сведения о рабочих областях на текущем компьютере, принадлежащих указанному пользователю, либо обо всех рабочих областях, связанных с конкретным Team Foundation Server. Для каждой рабочей области Team Foundation отображает имя, владельца, комментарий и имя компьютера. При выводе более подробных данных указываются и сопоставления рабочей области. До предоставления условий фильтрации, например имени владельца, компьютера или рабочей области, Team Foundation отображает только сведения о созданных рабочих областях.
Дополнительные сведения об изменении свойств рабочих областей см. в разделе Команда Workspace.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Примеры
В следующем примере отображается список всех рабочих областей для текущего пользователя на текущем компьютере.
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
См. также
Задачи
Создание рабочей области и получение файлов
Ссылки
Синтаксис командной строки (управление версиями)
Основные понятия
Создание рабочей области для работы с командным проектом