Compartir a través de


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.

SugerenciaSugerencia

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

Comandos de información

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

Comandos de la utilidad Tf de la línea de comandos