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