Comando get (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 get del Control de versiones de Team Foundation (TFVC) obtiene, o descarga, la versión más reciente o una versión especificada de uno o varios archivos o carpetas de Azure DevOps Server en el área de trabajo. El comando tf get proporciona una interfaz de usuario diferente a la de Visual Studio, pero el proceso es básicamente el mismo. Para obtener más información sobre cómo usar Visual Studio para obtener archivos y carpetas, vea Descargar u obtener archivos del servidor.

Requisitos previos

Vea Permisos de TFVC predeterminados.

Sintaxis

tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]

Parámetros

Parámetro

Descripción

/all

Puede usar esta opción para restaurar un elemento que haya eliminado accidentalmente de un área de trabajo del servidor. Si usa un área de trabajo local, lo cual es recomendable, es poco probable que tenga que usar esta opción.

TFVC mantiene un registro interno de todos los elementos que el área de trabajo contiene, incluida la versión de cada uno. Al obtener archivos, si el registro interno del servidor señala que el área de trabajo ya tiene la versión que se va a recibir, el comportamiento predeterminado es no recuperar el elemento. Esta opción obtiene todos los elementos, independientemente de los datos que el registro interno contiene.

/force

Combina /all y /overwrite.

<itemspec>

Especifica el ámbito de los elementos que se van a obtener. Se puede especificar más de un argumento itemspec. Si no se proporciona ningún itemspec, el sistema obtiene de forma recursiva todos los elementos del área de trabajo actual.

Para obtener la sintaxis, vea Uso de comandos de Control de versiones de Team Foundation.

/login <username>,[<password>]

Especifica la cuenta de usuario que ejecuta el comando. Vea Uso de comandos de Control de versiones de Team Foundation.

/noautoresolve

En materia de conflictos, el sistema trata de resolverlos todos automáticamente de forma predeterminada. Para obtener más información, vea Resolución de conflictos de Control de versiones de Team Foundation. Especifique esta opción para deshabilitar este comportamiento predeterminado.

/noprompt

Suprime la visualización de ventanas y cuadros de diálogo de Visual Studio y redirige los datos de salida al símbolo del sistema. Vea Uso de comandos de Control de versiones de Team Foundation.

/overwrite

De forma predeterminada, el sistema no recupera un elemento si es grabable (es decir, si el atributo de solo lectura está desactivado) en el equipo cliente. Esta opción invalida el comportamiento predeterminado y sobrescribe un elemento grabable, a menos que el elemento esté desprotegido. Si usa un área de trabajo local, como se recomienda, es poco probable que tenga que usar esta opción.

/preview

Muestra lo que ocurriría si no se ejecutara realmente la operación get.

/recursive

Obtiene de forma recursiva los elementos del directorio especificado y de los subdirectorios. Si no se especifica itemspec, se usa esta opción de forma implícita.

/remap

Vea el blog de phkelley: tf get /remap.

/version:<versionspec>

Especifica la versión máxima o las versiones mínima y máxima que se muestran en los datos del historial. El valor predeterminado es /version:T, que es la versión más reciente.

Para obtener la sintaxis, vea Uso de comandos de Control de versiones de Team Foundation.

Observaciones

• Si va a iniciar una nueva tarea, probablemente sea conveniente ejecutar tf get para descargar los archivos más recientes del servidor para poder extraerlos del repositorio y ponerse con la tarea. tf get se puede ejecutar desde cualquier carpeta del área de trabajo.

• Según sea necesario, tf get crea carpetas en el disco para contener los elementos secundarios que el comando descarga.

• Si quiere ver información sobre el historial de un elemento, use el comando history y el comando changeset.

• Si le preocupa qué cambios podrían producirse en los archivos del área de trabajo, puede usar la opción /preview para ver esos cambios sin implementarlos de facto.

• Los conflictos podrían bloquear la operación get. Una causa habitual de conflictos es intentar obtener un elemento en el que hay cambios pendientes. Puede usar el comando resolve para resolver estos conflictos.

Ejemplos

En los siguientes ejemplos se da por hecho que $/SiteApp/Main/ asigna a c:\code\SiteApp\Main\ en el área de trabajo.

Obtener la versión más reciente de todos los elementos en un área de trabajo

El comando tf get obtiene de forma predeterminada las versiones más recientes de todos los elementos del área de trabajo. Por ejemplo, el siguiente comando obtiene de forma recursiva todos los archivos en $/SiteApp/Main/, incluidas todas las carpetas secundarias.

c:\code\SiteApp\Main>tf get

Obtener de forma recursiva la versión más reciente de los elementos de cierto tipo en una carpeta

En el siguiente ejemplo se obtiene la versión más reciente de todos los archivos de C# en c:\code\SiteApp\Main\SolutionA\Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive

Obtener la versión más reciente de un archivo

En el siguiente ejemplo se obtiene la versión más reciente de program.cs en Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs

Obtener una versión específica de un archivo

En el siguiente ejemplo se obtiene la versión 8 de program.cs en Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8

Obtener la versión más reciente de dos archivos

En el siguiente ejemplo se obtienen las versiones más recientes de file1.cs y file2.cs en Project1.

c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs

Sincronización de un área de trabajo para que coincida con una versión del código base del equipo

En el siguiente ejemplo, el área de trabajo se sincroniza para que coincida con el código base tal cual estaba cuando se creó el conjunto de cambios 15:

c:\code\SiteApp\Main>tf get /v:15

• El nombre y el contenido de cada elemento del área de trabajo se cambia para que coincida con el estado que tenía en el servidor.
• Los elementos que se eliminaron después que el conjunto de cambios se restauran en el área de trabajo.
• Los elementos que se agregaron después que el conjunto de cambios se eliminan del área de trabajo.

Sincronización de un área de trabajo para que coincida con una versión etiquetada del código base del equipo

En el ejemplo siguiente se sincroniza el área de trabajo para que coincida con los elementos del código base con la etiqueta LastKnownGood:

c:\code\SiteApp\Main>tf get /v:LLastKnownGood

• El nombre y el contenido de cada elemento etiquetado del área de trabajo se cambia para que coincida con el estado que tenía en el servidor.
• Los elementos etiquetados que se eliminaron se restauran en el área de trabajo.
• Los elementos no etiquetados en el servidor se eliminan del área de trabajo.