Status (Comando)

Muestra información sobre los cambios pendientes en los elementos de 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 [/collection:TeamProjectCollectionUrl] [/login:username,[password]] ([/workspace:workspacename[;workspaceowner]]|[/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 (Control de versiones). Nota Puede especificar más de un argumento Itemspec.
TeamProjectCollectionUrl	La dirección URL de la colección de proyectos de equipo sobre la que desea mostrar información de estado (por ejemplo, http://myserver:8080/tfs/DefaultCollection).
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
/collection	Identifica la colección del proyecto de equipo.
/login	Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server.
/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 realizados en ellos que están pendientes de protección. Detailed muestra información de estado completa. El valor predeterminado es Brief.
/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.

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 Rename (Comando, 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:*

En el siguiente ejemplo se muestra información sobre todos los cambios pendientes del usuario actual en todas las áreas de trabajo de la colección que se encuentra en http://myserver:8080/tfs/DefaultCollection/.

c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:*

En el siguiente ejemplo se muestra información sobre todos los cambios que Joe ha realizado pero no ha protegido, en todas las áreas de trabajo de la colección que se encuentra en http://myserver:8080/tfs/DefaultCollection/.

c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:* /user:Joe

Vea también

Referencia

Sintaxis de la línea de comandos (Control de versiones)

Changeset (Comando)

Shelvesets (Comando)

Conceptos

Crear un área de trabajo para trabajar con el proyecto de equipo

Cambios pendientes

Trabajar con conjuntos de cambios

Trabajar con conjuntos de cambios aplazados

Comandos de información

Otros recursos

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

Comparar carpetas y archivos