Команда Dir
Команда dir предназначена для отображения содержимого сервера Team Foundation (подсистема контроля версий) или части сервера.
Необходимые разрешения
Для использования команды dir необходимо иметь разрешение Чтение со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Параметры
Аргумент |
Описание |
|---|---|
itemspec |
Определяет файл или папку, сведения о которых следует вернуть. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить какие из них находятся в области его действия, см. в разделе Параметры командной строки. .gif "Примечание") Примечание
Можно указать более одного аргумента Itemspec.
|
versionspec |
Предоставляемое пользователем значение параметра /version. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций версий для определения элементов, находящихся в области его действия, см. в разделе Синтаксис командной строки (управление версиями). |
username |
Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя. |
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, содержащей один и более файлов или папок, о которых необходимо отобразить данные (например, http://myserver:8080/tfs/DefaultCollection). |
Параметр |
Описание |
|---|---|
/version |
Указывает, что Team Foundation должен отобразить файлы и папки только определенной версии. |
/recursive |
Отображает все файлы и вложенные папки в указанном каталоге. |
/folders |
Отображает только папки. |
/deleted |
Отображает удаленные и существующие элементы. После удаленных элементов следует X3, где 3 — идентификатор удаления. |
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
/collection |
Указывает коллекцию командных проектов. |
Заметки
Команда dir работает с копиями файлов сервера Team Foundation (подсистема контроля версий), а не с локальными копиями. Команда использует локальную сопоставленную папку для поиска соответствующего пути сервера Team Foundation (подсистема контроля версий). Команда используется для просмотра сервера Team Foundation (подсистема контроля версий) и определения нужных файлов для получения.
Ссылки на другие команды Team Foundation, предоставляющие дополнительные сведения об элементах на сервере Team Foundation (подсистема контроля версий) и рабочих областях, сопоставленных с ним, см. в разделе Информационные команды.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Примеры
В следующем примере отображается список файлов, папок, вложенных папок и файлов в них в папке сервера Team Foundation (подсистема контроля версий), которой сопоставлен путь c:\projects. В списке также указано количество элементов. Дополнительные сведения о просмотре и изменении сопоставлений рабочей папки см. в разделах Команда Workspace или Команда Workfold.
c:\projects>tf dir /recursive
В следующем примере отображаются все файлы сервера Team Foundation (подсистема контроля версий) по этому пути. Вложенная папка "314dir" не должна существовать в локальной папке.
c:\projects>tf dir 314dir
В следующем примере отображаются версии файлов с меткой "My label" в этом пути сервера Team Foundation (подсистема контроля версий). Вложенная папка "314dir" не должна существовать в локальной папке.
c:\projects>tf dir /version:L"My label" 314dir
В следующем примере отображаются все папки в корне сервера Team Foundation (подсистема контроля версий). Локальная рабочая папка пропускается, поскольку $/ обозначает путь сервера Team Foundation (подсистема контроля версий).
c:\projects>tf dir /folders $/
В следующем примере отображаются все файлы и папки сервера Team Foundation (подсистема контроля версий).
c:\projects>tf dir /recursive $/
В следующем примере отображаются все элементы в текущей папке, удаленные элементы имеют идентификаторы удаления.
c:\projects>tf dir /deleted
См. также
Задачи
Добавление и удаление рабочей папки в рабочей области