Get (Comando)
Obtenga (descargue) la última versión o una versión especificada de uno o varios archivos o carpetas de Team Foundation Server al área de trabajo. Aunque el comando de Get proporciona una interfaz de usuario diferente a la de Visual Studio (vea Descargar (obtener) archivos del servidor), el proceso es fundamentalmente igual.
Requisitos: vea Referencia de permisos para Team Foundation Server.
tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]
Parámetros
Parámetro |
Descripción |
---|---|
/all |
Si utiliza área de trabajo local (recomendado), entonces es improbable que necesite utilizar esta opción. Puede utilizar esta opción para restaurar un elemento que ha eliminado accidentalmente de un área de trabajo del servidor. Team Foundation Server mantiene un registro interno de todos los elementos que el área de trabajo contiene, incluida la versión de cada uno. De forma predeterminada, cuando se obtiene los archivos, si el registro interno del servidor indica que el área de trabajo ya tiene la versión que está recopilando, no recupera el elemento. Esta opción obtiene los elementos independientemente de los datos contenidos en este registro interno. |
/force |
Combina /all y /overwrite. |
itemspec |
Especifica el alcance de los elementos a obtener. Puede especificar más de un argumento itemspec. Si no se proporciona ningún itemspec, el sistema obtiene recursivamente todos los elementos del área de trabajo actual. Para obtener información sobre la sintaxis, vea Usar los comandos del control de versiones de Team Foundation. |
/login:username,[password] |
Especifica la cuenta de usuario que ejecuta el comando. Vea Usar los comandos del control de versiones de Team Foundation. |
/noautoresolve |
De forma predeterminada, el sistema intenta automáticamente Resolver todos automáticamente (vea Resolver conflictos del control de versiones de Team Foundation). Puede especificar esta opción para deshabilitar este comportamiento predeterminado. |
/noprompt |
Suprime la presentación de ventanas y cuadros de diálogo y redirige los datos de salida a la ventana de símbolos del sistema. Vea Usar los comandos del control de versiones de Team Foundation. |
/overwrite |
Si utiliza área de trabajo local (recomendado), entonces es improbable que tenga que utilizar esta opción. De forma predeterminada, el sistema no recupera un elemento si es editable (es decir, si desactiva el atributo de solo lectura) en el equipo cliente. Esta opción reemplaza el comportamiento predeterminado y sobrescribe un elemento modificable, a menos que el elemento esté desprotegido. |
/preview |
Muestra lo que ocurriría sin realizar realmente la operación Get. |
/recursive |
Recursivamente se obtienen todos los elementos en el directorio especificado y en los subdirectorios. Si no se especifica itemspec, entonces se requiere esta opción. |
/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 (la versión más reciente). Para obtener información sobre la sintaxis, vea Usar los comandos del control de versiones de Team Foundation. |
Ejemplos
En todos los siguientes ejemplos, suponga que $/SiteApp/Main/ está asignado a c:\code\SiteApp\Main\ en el área de trabajo.
Obtener la última versión de todos los elementos en un área de trabajo
c:\code\SiteApp\Main\SolutionA>tf get
Se obtiene la última versión de todos los elementos del área de trabajo. Por ejemplo, el comando anterior obtendría recursivamente todos los archivos de $/SiteApp/Main/ incluidas todas sus subcarpetas.
Obtener recursivamente la última versión de los elementos de un tipo en una carpeta
c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive
Se obtiene la última versión de todos los archivos de C# (.cs) en c:\code\SiteApp\Main\SolutionA\Project1.
Obtener la última versión de un archivo
c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs
Se obtiene la última versión de program.cs en Project1.
Obtener una versión específica de un archivo
c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8
Se obtiene la versión 8 de program.cs en Project1.
Obtener la versión más reciente de dos archivos
c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs
Se obtiene la última versión de file1.cs y de file2.cs en Project1.
Sincronizar un área de trabajo para una versión del código base del equipo
c:\code\SiteApp\Main>tf get /v:15
Sincroniza el área de trabajo para que coincida con el código base tal como era cuando se creó el conjunto de cambios 15:
El nombre y el contenido de cada elemento del área de trabajo se cambia para coincidir con el estado que tenía en el servidor.
Los elementos que se eliminaron después de que el conjunto de cambios se restaurara en el área de trabajo.
Los elementos que se agregaron después de que el conjunto de cambios se eliminara en el área de trabajo.
Sincronizar un área de trabajo para que coincida con una versión etiquetada del código base del equipo
c:\code\SiteApp\Main>tf get /v:LLastKnownGood
Se sincroniza el área de trabajo para buscar los elementos del código base que son etiquetados Último conjunto de control correcto conocido:
El nombre y el contenido de cada elemento etiquetado del área de trabajo se cambia para coincidir con el estado que tenía en el servidor.
Los elementos etiquetados que se eliminaron se restablecen en el área de trabajo.
Los elementos no etiquetados en el servidor se eliminan del área de trabajo.
Uso en Visual Studio
- Descargar (obtener) archivos del servidor Utilice Visual Studio para obtener los archivos y carpetas.
Sugerencias
Si se inicia una nueva tarea, probablemente sea conveniente ejecutar tf get (puede hacerlo desde cualquier directorio del área de trabajo) para descargar los últimos archivos desde el servidor para poder desproteger los archivos e iniciar el trabajo.
Según sea necesario, este comando crea carpetas en el disco para contener elementos secundarios que el comando descarga.
Puede ver la información del historial de un elemento mediante History (Comando) y Changeset Command.
Si le preocupa qué cambios podrían aparecer en los archivos en el área de trabajo, puede utilizar la opción de /preview para ver los cambios que van a producirse sin implementarlos realmente.
Los conflictos pueden bloquear su obtención. Una causa habitual de conflictos es intentar obtener un elemento en el que se tenga cambios pendientes. Puede utilizar el Resolve Command para resolver estos conflictos de datos.