Comando Status (Control de versiones de Team Foundation)

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

El comando status de Control de versiones de Team Foundation (TFVC) o su alias, stat, muestra información sobre los cambios pendientes en archivos y carpetas, así como candidatos a cambios pendientes en una o varias áreas de trabajo. Cuando utiliza la opción /shelveset, el comando muestra información sobre los cambios pendientes en un conjunto de cambios agregados pendientes de confirmación.

Nota:

Un candidato de cambio pendiente es un archivo en la carpeta o subcarpeta del área de trabajo que no se ha agregado al control de versiones. Para ver todos los candidatos a cambios pendientes en Visual Studio, vaya a Team Explorer>Cambios pendientes>Cambios excluidos y, después, seleccione Detectados.

Requisitos previos

A fin de usar el comando status, debe tener el permiso Leer para el elemento de origen y los permisos Extraer del repositorio y Combinar para la carpeta de destino establecida en Permitir. Para obtener más información, vea Permisos predeterminados de TFVC.

Sintaxis

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

Parámetros

Argumentos

Argument

Descripción

/collection: <TeamProjectCollectionUrl>

Al utilizar la opción /workspace, se especifica la dirección URL de la colección de proyectos que incluye el área de trabajo que contiene los cambios pendientes. Por ejemplo: http://myserver:8080/tfs/DefaultCollection.

Si no se especifica, de forma predeterminada se supone que la colección de proyectos es la que contiene el área de trabajo que asigna el directorio actual.

Se omite si no usa la opción /workspace.

Nota:

Vea Comentarios para consultar las limitaciones de esta opción.

/format

Especifica el nivel de detalle con el que se muestran los cambios pendientes:

  • Brief (valor predeterminado): muestra una línea sobre cada cambio pendiente que incluye el nombre de archivo, los cambios, si el elemento está bloqueado (indicado por un símbolo de asterisco *), la ruta de acceso local y el usuario (si utiliza las opciones /collection y /workspace). Algunos datos podrían aparecer truncados.
  • Detailed: muestra una descripción completa de cada cambio pendiente. Además de la información anterior, esta opción muestra más datos, como la fecha y la hora.

<itemspec>

Especifica los elementos para los que desea obtener datos de los cambios pendientes. Para obtener la sintaxis, vea Uso de comandos del control de versiones de Team Foundation. Puede especificar más de un argumento itemspec.

/login

Especifica la cuenta de usuario que se va a utilizar para ejecutar el comando. Vea Uso de comandos del control de versiones de Team Foundation.

/recursive

Recupera de forma recursiva datos sobre los cambios pendientes en los elementos del directorio especificado o en cualquier subdirectorio.

/shelveset:<shelvesetname>[;<shelvesetowner>]

Especifica el conjunto de cambios aplazados que contiene los cambios que desea mostrar.

Esta opción no se puede combinar con la opción /workspace.

/user

Muestra todos los cambios pendientes realizados por el usuario especificado. Con el símbolo de asterisco * se incluyen los datos de los cambios de todos los usuarios. El valor predeterminado es el usuario actual.

Valores aceptables para esta opción:

  • <username>
  • <useraccount>
  • Asterisco *

Nota:

Vea Comentarios para consultar las limitaciones de esta opción.

/workspace:<workspacename>[;<workspaceowner>]

Especifica el nombre del área de trabajo que contiene los cambios pendientes. Si no se especifica, el área de trabajo es el que asigna el directorio actual.

Puede especificar workspaceowner para obtener los datos de los cambios pendientes en un área de trabajo que pertenece a un usuario específico. Si no se especifica, se supone que el área de trabajo es el usuario actual y, si se especifica, el valor de /login:<username>.

Esta opción no se puede combinar con la opción /shelveset.

Nota:

Vea Comentarios para consultar las limitaciones de esta opción.

Observaciones

Puede utilizar el comando status para ver los cambios pendientes en el área de trabajo actual; por ejemplo, el área de trabajo que asigna el directorio actual, independientemente de si se trata de un área de trabajo local o un área de trabajo del servidor. También puede utilizar este comando para ver los cambios pendientes en un área de trabajo de servidor remoto; por ejemplo, los cambios que realiza otro usuario en otra máquina de desarrollo, mediante las opciones /collection, /user y /workspace. Pero no puede ver los cambios pendientes en un área de trabajo local remota.

Para obtener más información, vea Decisión entre usar un área de trabajo local o de servidor.

Ejemplos

En todos los ejemplos siguientes, se da por hecho que $/SiteApp/Main/ está asignado a c:\code\SiteApp\Main\ en el área de trabajo.

Mostrar todos los cambios en el área de trabajo actual

En el ejemplo siguiente se muestran todos los cambios pendientes en el área de trabajo:

c:\code\SiteApp\Main\SolutionA\>tf stat

Mostrar todos los cambios en una carpeta

En el ejemplo siguiente se muestran todos los cambios pendientes en todos los elementos de la carpeta SolutionA:

c:\code\SiteApp\Main>tf stat SolutionA\*

Mostrar todos los cambios en una carpeta y sus subcarpetas

En el ejemplo siguiente se muestran los cambios pendientes en todos los elementos de la carpeta SolutionA, incluidos los cambios en sus subcarpetas:

c:\code\SiteApp\Main>tf stat SolutionA\* /recursive

Pasos siguientes