Sintaxis de la línea de comandos (Control de versiones)
La sintaxis para los comandos tf, una utilidad de la línea de comandos de Team Foundation , es la siguiente:
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] denota 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 son dos, la canalización (**|**opciones 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|@archivoDeComentarios] indica que se puede escribir un comentario para un Conjunto de cambios después de la opción /comment: o ( |) puede utilizar la sintaxis **@**commentfile 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:\proyectos>tf shelvesets BuddyTest_23
Caracteres especiales de la línea de comandos
Puede utilizar el carácter "@" (también conocido como 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 los comandos anteriores, 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 de la especificación del elemento, es un conjunto de uno o más caracteres que Team Foundation intenta resolver como un elemento o conjunto de elementos direccionable, en su equipo o en el servidor del 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, o 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 "Sugerencia") Sugerencia |
|---|
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 cualquiera 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 de .NET Framework compatible. — 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 |
Versión descargada más recientemente en su área de trabajo con el comando get. |
Wworkspacename;workspaceowner |
Versión descargada más recientemente en el área de trabajo especificada con el comando get. Ejemplo: WResolveRIConflicts;AKerry |
T |
Versión más reciente. |
Cuando utiliza los comandos History o Difference, puede especificar un intervalo de versiones separándolas con una tilde (~).
Vea también
Referencia
Opciones de la línea de comandos
Conceptos
Trabajar con conjuntos de cambios aplazados
Trabajar con conjuntos de cambios
Otros recursos
Referencia de la línea de comandos del control de versiones de Team Foundation