Comando View (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 Control de versiones de Team Foundation (TFVC) view recupera una versión específica de un archivo, la almacena en una carpeta temporal del equipo y la muestra.

Requisitos previos

Para usar el comando view, debe tener el permiso Lectura establecido en Permitir. Para más información, vea Permisos predeterminados de TFVC.

Sintaxis

tf view [/collection:<team-project-collection-url>] [/console] [/recursive] [/output:<local-file>]
[/shelveset:<shelveset-name>[;<owner>]] [/noprompt] <item-spec> 
[/version:<version-spec>] [/login:<username>,[<password>]]

Parámetros

En las secciones siguientes se describen los argumentos y las opciones del comando view.

Argumentos

Argument

Descripción

<team-project-collection-url>

Proporciona la dirección URL de la colección de proyectos que contiene una versión específica de un archivo sobre el que quiere recuperar información, por ejemplo, https://myserver:8080/tfs/DefaultCollection.

<shelveset-name> [:<owner>]

Identifica el conjunto de cambios agregados pendientes de confirmación. El argumento opcional <owner> se usa para especificar un conjunto de estantes que no pertenece al usuario actual.

<item-spec>

Identifica el archivo o la carpeta que se va a recuperar. Para obtener más información sobre la manera en que TFVC analiza <item-spec> para determinar qué elementos están dentro del ámbito, vea Uso de comandos de Control de versiones de Team Foundation: uso de opciones para modificar el funcionamiento de un comando.

Nota:

Puede especificar más de un argumento <item-spec>.

<version-spec>

Proporciona un valor como C3 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 este valor como DOMAIN\<username> o <username>.

<password>

Proporciona un valor a la opción /login.

<local-file>

Proporciona la ruta de acceso a la carpeta del archivo de salida.

Opciones

Opción

Descripción

/console

Especifica que la salida del archivo se debe dirigir a la consola. Esta opción es útil si quiere escribir el archivo en el disco mediante el redireccionamiento de la consola, pero use un nombre o ubicación diferente al elemento con versiones.

/recursive

Visualiza todos los elementos del directorio especificado y de sus subdirectorios.

/shelveset

Especifica el conjunto de estantes por nombre.

/noprompt

Especifica que TFVC no debe preguntarte antes de mostrar cada archivo cuando incluya una expresión comodín en un argumento <item-spec>que coincida con más de un archivo.

/version

Especifica la versión del archivo que se va a abrir para ver. Si omite esta opción, view recupera la versión más reciente del servidor de Azure DevOps.

/collection

Especifica el nombre de la colección de proyectos.

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps.

/output

Genera el archivo en una carpeta local en lugar de invocar un shell de Windows para abrir el archivo.

Observaciones

El comando view de la utilidad de línea de comandos tf recupera una copia de solo lectura de un archivo del servidor de Azure DevOps, almacena el archivo en una carpeta temporal del equipo y muestra el contenido del archivo. A menos que especifique una versión determinada, TFVC recupera la versión más reciente del archivo del servidor de Azure DevOps.

El comando view no agrega archivos al área de trabajo ni los revisa. Para obtener más información sobre cómo obtener la versión del servidor de Azure DevOps de un archivo y extraerlo del repositorio, consulte Obtener comando y Comandos Extraer del repositorio y Editar.

Puede usar el comando difference para ver las diferencias entre dos versiones de un archivo. Para obtener más información, vea Comando Diferencia.

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.

Opciones de salida

  • De forma predeterminada, TFVC muestra el contenido del archivo en el visor asociado a su tipo de archivo.

  • Si incluye la opción /console, TFVC imprime el contenido del archivo en la consola de comandos. Del mismo modo, si TFVC no puede encontrar un visor para el tipo de archivo que especificó, imprime el contenido del archivo en la consola de comandos.

  • Puede redirigir el contenido de un archivo a una salida estándar mediante | o \>. Esta opción proporciona una manera de guardar el archivo en otro archivo o pasarlo a otro programa para el posprocesamiento.

Ejemplos

En el ejemplo siguiente se muestra la versión más reciente del archivo 314.cs:

c:\projects>tf view 314.cs

En el ejemplo siguiente se muestra la versión de 314.cs que se insertó en el repositorio con el conjunto de cambios 1999:

c:\projects>tf view /version:C1999 314.cs

En el ejemplo siguiente se recupera la versión 5 de 314.cs y se escribe en el archivo 314.old:

c:\projects>tf view /version:5 314.cs > 314.old

En el ejemplo siguiente se muestra la versión más reciente de cada archivo que coincide con la expresión comodín *.cs:

c:\projects>tf view *.cs