Команда "dir"
Обновлен: Ноябрь 2007
Команда dir предназначена для отображения содержимого сервера Team Foundation (подсистема контроля версий) или части сервера Team Foundation (подсистема контроля версий).
Требуемые разрешения
Для использования команды dir необходимо иметь разрешение Чтение со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf dir [/server:servername] itemspec [/version:versionspec]
[/recursive] [/folders] [/deleted]
Параметры
Аргумент |
Описание |
|---|---|
servername |
Предоставляемое пользователем значение параметра /server. Пример:"teamfoundation2". |
itemspec |
Определяет файл или папку, сведения о которых следует вернуть. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить какие из них находятся в области его действия, см. в разделе Параметры командной строки. |
versionspec |
Предоставляемое пользователем значение параметра /version. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций версий для определения элементов, находящихся в области его действия, см. в разделе Синтаксис командной строки (Team System). |
Параметр |
Описание |
|---|---|
/server |
Определяет значение Team Foundation Server. Этот параметр является обязательным, если вызов команды осуществляется из каталога, который не сопоставлен рабочей области. |
/version |
Указывает, что Team Foundation должен отобразить файлы и папки только определенной версии. |
/recursive |
Отображает все файлы и вложенные папки в указанном каталоге. |
/folders |
Отображает только папки. |
/deleted |
Отображает удаленные и существующие элементы. После удаленных элементов следует X3, где 3 — идентификатор удаления. |
Заметки
Команда 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