Sintaxis de la línea de comandos (Team System)
Actualización: noviembre 2007
Sintaxis de la utilidad de línea de comandos tf.exe.
tf command item [/options]
En este tema se describen las convenciones de la documentación, así como los métodos abreviados de comandos, los caracteres especiales de la línea de comandos y los parámetros específicos de Team Foundation, versionspec e itemspec.
Convenciones de la documentación
[/Brackets] representa las opciones que no son necesarias para ejecutar un comando. Los elementos que no se encuentran entre corchetes representan parámetros que son necesarios para completar la operación. Por ejemplo, en el comando siguiente, itemspec es obligatorio y /recursive es opcional:
Ejemplo de sintaxis: c:\projects>tf getitemspec [/recursive]
Comando real: c:\projects>tf get c:\projects /recursive
Comando alternativo: c:\projects>tf get /recursive
En el ejemplo de comando alternativo, Team Foundation deduce que se pretende obtener el contenido del directorio actual, c:\projects, y todas sus subcarpetas. Por tanto, aunque se requiere el parámetro itemspec, no hay que escribirlo necesariamente.
Cuando dos opciones de canalización separadas por (|) se incluyen en un conjunto de corchetes, se puede especificar cualquiera de ellas, pero no ambas opciones. Por ejemplo, tf Changeset [/comment:comentario|@archivoDeComentario] indica que puede escribir un comentario para un conjunto de cambios después de la opción /comment: o (|) puede utilizar la sintaxis **@**archivoDeComentario para especificar una ruta de acceso a un archivo que contiene un comentario que desea utilizar. Sin embargo, no puede especificar comentario y archivoDeComentario.
En los ejemplos de sintaxis, los elementos en cursiva son parámetros que debe reemplazar con caracteres reales para ejecutar un comando. Los elementos en negrita son opciones que debe incluir literalmente. Por ejemplo:
Ejemplo de sintaxis:tf shelvesetsshelvesetname [/recursive]
Comando real:c:\projects>tf shelvesets BuddyTest_23
Caracteres especiales de la línea de comandos
Puede utilizar el carácter “@” (el modificador de línea de comandos), para ejecutar un conjunto de comandos de Team Foundation al mismo tiempo. La principal ventaja de utilizar un modificador de la línea de comandos desde el símbolo del sistema, un archivo de comandos o en un archivo por lotes o de script es que puede ser mucho más rápido utilizar dicho modificador que ejecutar cada uno de los comandos. Para obtener más información, vea Opciones de la línea de comandos.
Métodos abreviados y alias de comandos
A continuación se definen los métodos abreviados y alias de comandos que admite la utilidad de línea de comandos tf:
del = delete
diff = difference
edit = checkout
hist = history
perm = permission
prop = properties
ren = rename
rename = move
stat = status
undel = undelete
Para obtener más información sobre estos comandos, vea Comandos de la utilidad Tf de la línea de comandos.
Cómo se analizan Itemspecs y Versionspecs mediante Team Foundation
Rutas de acceso de Itemspec
Itemspec, que es la abreviatura inglesa de especificación de elemento, es un conjunto de uno o varios caracteres que Team Foundation resuelve como un elemento o conjunto de elementos que hacen referencia al sistema de archivos o a las rutas UNC asignadas a un área de trabajo o al servidor de control de versiones.
En todos los comandos de Team Foundation que aceptan un itemspec, puede especificar rutas de acceso del sistema de archivos local como c:\projects, rutas de acceso UNC como \\myshare\projects o rutas de acceso de servidor como $/projects/myfiles.
En las rutas de acceso locales, puede proporcionar rutas de acceso relativas. Por ejemplo, si el directorio actual es c:\projects y desea desproteger todos los elementos de un subdirectorio de la carpeta projects, puede escribir tf checkout .\* /recursive.
.gif "Nota") Nota: |
|---|
Puede utilizar caracteres comodín en los comandos de Control de versiones de Team Foundation, por ejemplo: *, ? y #. |
Si el itemspec especifica una ruta de acceso al servidor, ésta debe ser completa. Por ejemplo, no puede desproteger todos los elementos situados bajo la carpeta $/projects utilizando ./* como itemspec.
Versionspecs
Un versionspec especifica la versión de un elemento con el que quiere trabajar. Puede especificar las versiones en un comando, ya sea incluyendo el versionspec como parte de la opción de versión (por ejemplo, /version:C1256) o agregando el versionspec a un nombre de archivo con un punto y coma (por ejemplo, filename;Lmylabel).
Utilice uno o varios de los modelos siguientes para especificar una versión.
Versionspec |
Descripción |
|---|---|
Conjunto de cambios |
Versión que pertenece al número de conjunto de cambios changeset. Ejemplo: C1256. |
Llabel |
Versión que pertenece a la etiqueta label. Ejemplo: Lmylabel. |
Dyyyy-mm-ddTxx:xx O bien Dmm/dd/yyyy O bien Cualquier formato compatible con .NET Framework. O bien Cualquiera de los formatos de fecha del equipo local. |
Cualquier formato de fecha y hora que puede analizar un método de .NET Framework. Ejemplo: D2008-01-21T16:00. Para obtener más información sobre los formatos de fecha y hora compatibles, vea DateTime (Estructura) en la Biblioteca de clases de .NET Framework. |
W |
La última versión recuperada en el área de trabajo con el comando get. |
T |
Última revisión. |
Cuando utiliza los comandos History, Difference o Merge, puede especificar un intervalo de versiones separándolas con una tilde (~). Vea los ejemplos siguientes sobre cómo especificar un intervalo separando las versiones con una tilde:
Ver únicamente el historial del archivo Form1.cs para el conjunto de cambios 137.
Ejemplo de sintaxis: **tf history /version:**C137~C137
Obtener la diferencia entre los conjuntos de cambios C123 y C125 del archivo form.cs.
Ejemplo de sintaxis: tf difference/versionC123~C125 form1.cs.
Combinar todas las versiones desde el primer conjunto de cambios hasta el conjunto de cambios C125 en bifurcación2.
Ejemplo de sintaxis: **tf merge/version:**C125 bifurcación1 bifurcación2.
Vea también
Conceptos
Trabajar con conjuntos de cambios aplazados del control de versiones
Trabajar con conjuntos de cambios del control de versiones
Referencia
Opciones de la línea de comandos
Otros recursos
Referencia de la línea de comandos del control de versiones de Team Foundation