Comando dir (Control de versiones de Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
El comando dir muestra todo o parte del contenido del servidor para control de versiones de Team Foundation (TFVC).
Requisitos previos
Para usar el comando dir, debe tener el permiso Lectura establecido en Permitir. Para más información, vea Permisos predeterminados de TFVC.
Sintaxis
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parámetros
Argumentos
Argument
Descripción
<itemspec>
Identifica el archivo o la carpeta sobre los que se va a devolver información. Para más información sobre cómo TFVC analiza itemspec para determinar qué elementos están dentro del ámbito, vea Uso de opciones para modificar cómo funciona un comando.
Nota:
Puede especificar más de un argumento itemspec.
<versionspec>
Valor proporcionado por el usuario para la opción /version. Para más información sobre cómo TFVC analiza una especificación de versión para determinar qué elementos están dentro de su ámbito, vea Uso de comandos de control de versiones de Team Foundation.
<username>
Proporciona un valor a la opción /login. Puede especificar un valor de nombre de usuario como DOMAIN\username o username.
<TeamProjectCollectionUrl>
Dirección URL de la colección de proyectos que contiene uno o varios archivos o carpetas sobre los que desea mostrar información, por ejemplo http://myserver:8080/tfs/DefaultCollection/.
Opciones
Opción
Descripción
/version
Especifica que TFVC solo debe mostrar archivos y carpetas de una versión determinada.
/recursive
Muestra todos los archivos y subcarpetas en el directorio especificado.
/folders
Muestra solo carpetas.
/deleted
Muestra los elementos eliminados y los elementos existentes. Los elementos eliminados se siguen con ;Xn donde n es el identificador de eliminación.
/login
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps.
/collection
Especifica el nombre de la colección de proyectos.
Observaciones
El comando dir funciona en las copias de archivos del servidor Azure DevOps, no en las copias locales. El comando usa la carpeta asignada local para buscar la ruta de acceso del servidor de Azure DevOps adecuada. Use este comando para explorar el servidor de Azure DevOps e identificar los archivos que pueda tener que obtener.
Para más información sobre cómo usar la utilidad de línea de comandos tf, vea Uso de comandos de control de versiones de Team Foundation.
Ejemplos
En el ejemplo siguiente se muestra una lista de archivos, carpetas, subcarpetas y archivos en la carpeta del servidor de Azure DevOps a la que se asigna c:\projects. También se muestra el número de elementos. Para más información sobre cómo ver y editar las asignaciones de carpetas de trabajo, consulte Comando workspace y Comando workfold.
c:\projects>tf dir /recursive
En el ejemplo siguiente se muestran todos los archivos de servidor de Azure DevOps en la ruta de acceso 314dir. La subcarpeta 314dir no tiene que existir en la carpeta local.
c:\projects>tf dir 314dir
El siguiente ejemplo muestra la versión de los archivos etiquetados como My label en la ruta 314dir del servidor Azure DevOps. La subcarpeta 314dir no tiene que existir en la carpeta local.
c:\projects>tf dir /version:L"My label" 314dir
En el ejemplo siguiente se muestran todas las carpetas de la raíz del servidor de Azure DevOps. Se omite la carpeta de trabajo local, ya que $/ indica una ruta de acceso del servidor de Azure DevOps.
c:\projects>tf dir /folders $/
En el ejemplo siguiente se enumeran todos los archivos y carpetas del servidor de Azure DevOps.
c:\projects>tf dir /recursive $/
En el ejemplo siguiente se enumeran todos los elementos de la carpeta actual, incluidos los elementos eliminados con sus identificadores de eliminación.
c:\projects>tf dir /deleted