Sintaxis de línea de comandos (Team Explorer Everywhere)
Ahora ha instalado Cliente multiplataforma de línea de comandos de Team Foundation Server. Pero antes de escribir cualquier comando, deberá comprender la sintaxis y la información de uso general.
En este tema
Especificar opciones
En los equipos de UNIX, las rutas de acceso absolutas comienzan con una barra diagonal (/), de modo que se usa un guión (-) a las opciones de inicio. Si no, Cliente multiplataforma de línea de comandos de Team Foundation Server no puede indicar una ruta de acceso desde una opción.
Uso de comillas y generación de caracteres de escape
Los shells de UNIX admiten muchos caracteres especiales para caracteres comodín, expresiones regulares, etc. Si esos argumentos contienen caracteres que el shell considera especiales, tiene que generar secuencias de escape o entrecomillar argumentos para comandos. Puede marcar el texto literal en los shells de UNIX como se muestra aquí:
Para conservar el valor literal del carácter, coloque delante una barra diagonal inversa (\). Por ejemplo,
tf checkout -recursive $/Inventory/Client\ Suite/Para conservar los valores literales de los caracteres incluidos, encierre el texto entre comillas sencillas (“"). Las variables de shell a las que se hace referencia con un signo de dólar ($) y comodines no se expanden si se encuentran dentro de comillas sencillas. Por ejemplo,
tf checkout -recursive ‘$/Inventory/Client Suite/’Para conservar el valor literal de los caracteres incluidos (excepto $, `, \ y !), encierre el texto entre comillas (“”).
Debido a estas excepciones, se expanden las variables, los shells secundarios se siguen evaluando y se puede seguir usando la barra diagonal inversa para usar caracteres de escape, y los eventos de historial se siguen expandiendo. El ejemplo siguiente muestra que todavía es necesaria una barra diagonal inversa para evitar ! de expandirse en un evento del historial.
tf checkin -comment:”Fixed the bug\!” file.java
Las rutas de acceso del servidor para Visual Studio Team Foundation Server comienzan con un signo de dólar, pero los shells de UNIX utilizan el signo de dólar para iniciar la expansión de variables. Los shells como sh, ksh, bash y zsh reconocen que el carácter en una ruta de acceso del servidor que aparece después del signo de dólar no es un nombre de variable válido. Por consiguiente, estos shells pasan el signo de dólar sin modificar al Cliente multiplataforma de línea de comandos de Team Foundation Server.
Sin embargo, los shells derivados de csh (incluido tcsh) no analizan la línea de comandos de esta manera. Estos shells leen el signo de dólar e intentan sustituir una variable que coincida con el texto que sigue. Como el texto siguiente es una barra diagonal (/) y estos shells requieren nombres de variable para empezar con una letra, se produce un error. Si usa los shells de csh o de tcsh, debe generar secuencias de escape con el signo del dólar en las rutas de acceso del servidor mediante una barra diagonal inversa o comillas sencillas. Las comillas dobles hacen que el shell intente expandir la variable. He aquí algunos ejemplos de establecimiento de secuencias de escape y de uso de comillas para los shells de csh:
tf checkout -recursive \$/Inventory/Client\ Suite/
tf checkout -recursive ‘$/Inventory/Client Suite/’
tf checkout -recursive \$”/Inventory/Client Suite/”
Especificaciones del elemento
Una especificación de elemento es una ruta local o de servidor que describe un archivo o carpeta que es un parámetro de entrada a una opción o a un comando para Cliente multiplataforma de línea de comandos de Team Foundation Server. Una especificación de elemento podría contener un sufijo de la especificación de la versión, separados por punto y coma. Este sufijo es opcional. Especifique el sufijo solo cuando desee hacer referencia a una versión histórica de un elemento.
Especificaciones del elemento de ejemplo:
Especificación del elemento |
Descripción |
|---|---|
$/Inventory/src |
Ruta de acceso del servidor a una carpeta |
$/Inventory/src/Class.java |
Ruta de acceso del servidor a un archivo |
/tmp/Inventory |
Ruta de acceso local (Unix) a una carpeta de trabajo |
/tmp/Inventory/src/Class.java |
Ruta de acceso local (Unix) a un archivo |
C:\Inventory\src |
Ruta de acceso local (Windows) a una carpeta de trabajo |
C:\Inventory\src\Class.java |
Ruta de acceso local (Windows) a un archivo |
$/Inventory/src;C4095 |
Ruta de acceso del servidor a una carpeta del conjunto de cambios 4095 |
. \Class.java;C129 |
Ruta de acceso local relativa (Windows) de un archivo del conjunto de cambios 129 |
./Class.java;Lrelease-1.0 |
Ruta de acceso local relativa (Unix) de un archivo de la etiqueta release (versión)-1.0 |
$/Inventory/src/file.txt;Wdev;john |
Ruta de acceso del servidor en la versión del área de trabajo de desarrollo que pertenece a John. |
file.txt; D01/01/2007 |
Ruta de acceso local el 1 de enero de 2007 .gif "Nota") Nota
Se admiten fechas ISO 8601.Las fechas se analizan según la configuración regional del usuario.
|
file.txt;X1067 |
Archivo previamente eliminado con deletionID 1067 |
Especificaciones de la versión
Una especificación de versión es una cadena con formato especial que hace referencia a una única versión específica o a un intervalo de versiones de un elemento en el control de versiones. Las especificaciones de la versión se utilizan de dos maneras: como sufijos en las especificaciones de elementos (vea Item Specifications anteriormente en este tema) y como valores independientes en la opción -version de ciertos comandos.
Especificaciones de la versión de ejemplo:
Formato de especificación de la versión |
Descripción |
|---|---|
T |
Versión más reciente. |
Cn |
La versión del conjunto de cambios n. |
LlabelID |
La versión de la etiqueta labelID. |
Wnombre; propietario |
La versión existente actualmente en el área de trabajo nombre que pertenece a propietario. |
Dcadena de fecha |
La versión en la fecha y hora especificada en cadena de fecha |
XdeletionID |
La versión que se eliminó y a la que el servidor asignó deletionID. |