Comando status
Actualización: noviembre 2007
Muestra información sobre los cambios pendientes a los elementos en una o más áreas de trabajo.
Permisos necesarios
Para usar el comando status, debe tener el permiso Leer establecido en Permitir para todos los archivos o carpetas especificados. Para obtener más información, vea Permisos de Team Foundation Server.
tf status itemspec [/server:servername] [/workspace:workspacename[;workspaceowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
tf status itemspec [/server:servername] [/shelveset:shelvesetname[;shelvesetowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
Parámetros
Argumento |
Descripción |
|---|---|
itemspec |
Identifica el archivo o carpeta cuyos detalles de estado se van a mostrar. Para obtener más información acerca de cómo Team Foundation analiza itemspecs para determinar qué elementos se encuentran en ese ámbito, vea Sintaxis de la línea de comandos (Team System). |
servername |
Valor proporcionado por el usuario para la opción /server. Ejemplo: http://teamfoundation2:8080. |
workspacename |
Valor proporcionado por el usuario para la opción /workspace. |
workspaceowner |
Especifica el nombre del usuario que creó el área de trabajo. |
shelvesetname |
Valor proporcionado por el usuario para la opción /shelveset. |
shelvesetowner |
Especifica el nombre del propietario del conjunto de cambios aplazados. |
username |
Proporciona un valor para la opción /user. Un valor de nombre de usuario se puede expresar de una de dos maneras según la configuración de la red: DOMINIO\nombreDeUsuario o nombreDeUsuario. |
Opción |
Descripción |
|---|---|
/server |
Identifica Team Foundation Server. Se requiere esta opción si el comando se invoca desde un directorio no asignado a un área de trabajo. |
/workspace |
Especifica el nombre del área de trabajo cuya lista de cambios desea ver. Si no se especifica esta opción y está ejecutando el comando desde un directorio que se ha agregado a un área de trabajo, se utiliza el área de trabajo actual. Esta opción no se puede combinar con la opción /shelveset. |
/shelveset |
Nombre del conjunto de cambios aplazados cuya lista de cambios desea ver. Esta opción no se puede combinar con la opción /workspace. |
/format |
Formato de la información de estado. Brief muestra una lista de cambios y los cambios que se han realizado en ellos con la protección pendiente. Detailed muestra información de estado completa. Brief es el valor predeterminado. |
/recursive |
Muestra información de estado para todos los elementos del directorio concreto y cualquier subdirectorio. |
/user |
Filtra la lista de cambios realizados en el usuario con nombre. Se puede utilizar un asterisco (*) para representar todos los usuarios. El valor predeterminado es el usuario actual. |
Comentarios
Puede utilizar el comando status para mostrar una lista de cambios pendientes. Un cambio pendiente es una revisión de archivo o carpeta que no se ha enviado al servidor y se ha empaquetado en un conjunto de cambios con control de versión. Para obtener más información, vea Cambios pendientes.
También puede especificar la opción /shelveset para mostrar información detallada sobre los cambios aplazados sin control de versión de los que está compuesto un conjunto de cambios aplazados. Para obtener más información sobre la diferencia entre los cambios pendientes y los cambios aplazados, vea Trabajar con conjuntos de cambios aplazados del control de versiones.
Para obtener vínculos a otros comandos de Team Foundation que proporcionan información adicional acerca de los elementos del servidor y todas las áreas de trabajo que tenga asignadas, vea Comandos de información.
Para obtener más información sobre cómo encontrar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.
Resultado del comando
Si el tipo de cambio pendiente es rename, se muestra el nuevo nombre. Para obtener más información, vea Comando rename (Control de versiones de Team Foundation).
Hay dos modos de presentación: brief (breve) y detailed (detallada).
/Format:brief muestra el nombre de archivo del elemento, la ruta de acceso local y nueva, si el elemento está bloqueado, el tipo de cambio pendiente que representa, el usuario que realizó el cambio y la ubicación de la versión de área de trabajo del elemento en disco. El resultado se ordena primero por carpeta y, a continuación, por nombre de archivo en la carpeta.
/Format:detailed presenta varias líneas de información sobre cada cambio pendiente en el resultado. El resultado detallado incluye lo mismo que el resultado breve, más la fecha y hora y otra información.
Ejemplos
El ejemplo siguiente muestra información sobre todos los cambios pendientes para el usuario actual en el área de trabajo actual. El área de trabajo actual es el área de trabajo a la que se asigna el directorio local.
c:\projects>tf status
El ejemplo siguiente muestra todos los cambios pendientes para el usuario actual bajo d:\src en el equipo actual.
c:\projects>tf status/recursive d:\src
El ejemplo siguiente muestra todos los cambios pendientes para el usuario actual en el área de trabajo Beta1.
c:\projects>tf status/workspace:Beta1
El ejemplo siguiente muestra información de estado sobre todos los cambios pendientes para el usuario Jason.
c:\projects>tf status/user:Jason
El ejemplo siguiente muestra información de estado sobre todos los cambios pendientes para todos los usuarios, en todas las áreas de trabajo del servidor.
c:\projects>tf status/user:*
El ejemplo siguiente muestra información sobre todos los cambios pendientes para el usuario actual en todas las áreas de trabajo en el servidor ubicado en teamserver2.
c:\projects>tf status/server:teamserver2 /workspace:*
El ejemplo siguiente muestra información sobre todos los cambios que Joe ha realizado pero no ha protegido en todas las áreas de trabajo asignadas al servidor teamserver2.
c:\projects>tf status/server:teamserver2 /workspace:* /user:joe
Vea también
Conceptos
Trabajar con espacios de trabajo del control de versiones
Trabajar con conjuntos de cambios del control de versiones
Trabajar con conjuntos de cambios aplazados del control de versiones
Referencia
Sintaxis de la línea de comandos (Team System)