Compartir vía

Comando Status (Control de versiones de Team Foundation)

  • Artículo

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

Visual Studio 2019 | de Visual Studio 2022

El comando Control de versiones de Team Foundation (TFVC) status, o su alias stat, muestra información sobre los cambios pendientes en archivos y carpetas y candidatos de cambio pendientes en una o varias áreas de trabajo. Cuando se usa la opción /shelveset, el comando muestra información sobre los cambios pendientes en un conjunto de estantes.

Nota

Un candidato de cambio pendiente es un archivo en la carpeta o subcarpeta del área de trabajo que no se agrega al control de versiones. Para ver todos los candidatos a cambios pendientes en Visual Studio, vaya a Team Explorer>Cambios pendientes>cambios excluidosy, a continuación, seleccione Se detectó.

Prerrequisitos

Para usar el comando , tenga el permiso Read para el elemento de origen y el Desactive y Combinar para la carpeta de destino establecida en Permitir. Para obtener más información, consulte 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

de argumentos de

descripción

/collection: <TeamProjectCollectionUrl>

Al usar la opción /workspace, especifica la dirección URL de la colección de proyectos que contiene 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

Consulte comentarios para conocer las limitaciones de esta opción.

/format

Especifica cuánto detalle se va a mostrar sobre cada cambio pendiente:

  • Brief (valor predeterminado): muestra una línea sobre cada cambio pendiente que incluye: nombre de archivo, cambios, si el elemento está bloqueado según lo indicado por un asterisco *, una ruta de acceso local y un usuario si usa las opciones /collection y /workspace. Es posible que algunos de los datos se trunquen.
  • 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 fecha y hora.

<itemspec>

Especifica los elementos para los que desea los datos modificados pendientes. Para obtener una sintaxis, consulte Usar comandos de control de versiones de Team Foundation. Puede especificar más de un argumento itemspec.

/login

Especifica la cuenta de usuario que se va a usar para ejecutar el comando. Consulte Usar comandos de control de versiones de Team Foundation.

/recursive

Recupera de forma recursiva los datos sobre los cambios pendientes en los elementos del directorio especificado y de los subdirectorios.

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

Especifica el conjunto de estantes que contiene los cambios que desea enumerar.

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

/user

Enumera todos los cambios pendientes realizados por el usuario especificado. Un * de asterisco incluye datos sobre los cambios de todos los usuarios. El valor predeterminado es el usuario actual.

Valores aceptables para esta opción:

  • <username>
  • <useraccount>
  • Asterisco *

Nota

Consulte comentarios para conocer 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 la que asigna el directorio actual.

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

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

Nota

Consulte comentarios para conocer las limitaciones de esta opción.

Observaciones

Puede usar 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 es un área de trabajo local o un área de trabajo de servidor. También puede usar este comando para ver los cambios pendientes en un área de trabajo del servidor remoto, por ejemplo los cambios realizados por otro usuario en otra máquina de desarrollo, mediante las opciones de /collection, /usery /workspace. Sin embargo, no puede ver los cambios pendientes en un área de trabajo local remota.

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

Ejemplos

En todos los ejemplos siguientes, supongamos que $/SiteApp/Main/ se asigna a c:\code\SiteApp\Main\ en el área de trabajo.

Enumeración de todos los cambios en el área de trabajo actual

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

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

Enumerar todos los cambios de una carpeta

En el ejemplo siguiente se enumeran todos los cambios pendientes en todos los elementos de la carpeta solutionA de :

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

Enumerar todos los cambios de una carpeta y sus subcarpetas

En el ejemplo siguiente se enumeran 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