Comando dir (Control de versiones de Team Foundation)

  • Artículo

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