Workspaces (Comando)
Muestra información sobre las áreas de trabajo en el sistema y actualiza la información almacenada en memoria caché sobre un cambio de nombre de usuario o nombre de equipo en el servidor que ejecuta Visual Studio Team Foundation Server.
Permisos necesarios
Para usar el comando workspaces, el permiso Leer debe estar establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.
tf workspaces [/owner:ownername] [/computer:computername]
[/collection:TeamProjectCollectionUrl] [/format:(brief|detailed)]
[/updateUserName:oldUserName] [/updateComputerName:oldComputerName]
[workspacename][/login:username,[password]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|TeamProjectCollectionUrl)
Parámetros
Argumento |
Descripción |
|---|---|
ownername |
Proporciona un valor para la opción /owner. Especifique "*" para buscar las áreas de trabajo creadas por cualquier usuario. |
computername |
Proporciona un valor para la opción /computer . Especifique "*" para buscar las áreas de trabajo en cualquier equipo. |
workspacename |
Especifica el nombre de un área de trabajo sobre la que se mostrará información. Si no se especifica workspacename, se mostrará información sobre todas las áreas de trabajo de un servidor. También puede utilizar el carácter comodín "*" para mostrar información sobre todas las áreas de trabajo de un servidor. |
oldUserName |
Proporciona el nombre de usuario anterior para la opción /updateUserName. |
oldComputerName |
Proporciona el nombre de equipo anterior para la opción /updateComputerName. |
TeamProjectCollectionUrl |
La dirección URL de la colección de proyectos de equipo que contiene las áreas de trabajo sobre las que desea mostrar información (por ejemplo, http://myserver:8080/tfs/DefaultCollection). |
username |
Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario. |
Opción |
Descripción |
|---|---|
/owner |
Especifica el nombre del usuario que creó el área de trabajo. Si no se especifica ningún propietario, Team Foundation devuelve información sobre las áreas de trabajo de las que sólo es propietario el usuario actual. |
/computer |
Especifica el nombre de un equipo cliente por el que filtrar la lista de áreas de trabajo del servidor. Si no se especifica ningún equipo, Team Foundation sólo devuelve información sobre las áreas de trabajo del equipo actual. |
/format |
Especifica el formato de la información del área de trabajo. Brief devuelve información del área de trabajo sin asignaciones. Detailed devuelve información del área de trabajo y también las asignaciones. El formato detallado solo se puede usar cuando se especifica la opción /collection . El valor predeterminado es Brief. |
/updateUserName |
Actualiza información de identificación de seguridad sobre el servidor Team Foundation para un usuario cuyo nombre de usuario de red ha cambiado. Si especifica esta opción, también debe especificar una colección de proyectos de equipo mediante la opción /collection. |
/updateComputerName |
Indica a Team Foundation que actualice las tablas para reflejar un cambio de nombre de un equipo cliente. Si especifica esta opción, también debe especificar una colección de proyectos de equipo mediante la opción /collection. |
/remove |
Quita de la caché del cliente las entradas del área de trabajo especificadas correspondientes a la colección de proyectos de equipo especificada. |
/collection |
Especifica la colección del proyecto de equipo. |
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Team Foundation Server. |
Comentarios
El comando workspaces de la utilidad de línea de comandos tf muestra información sobre las áreas de trabajo en el equipo actual de las que es propietario un usuario concreto o sobre todas las áreas de trabajo asociadas a un Team Foundation Server específico. Para cada área de trabajo, Team Foundation muestra el nombre, el propietario, el comentario y el nombre de equipo. Con resultados detallados, también muestra las asignaciones del área de trabajo. A menos que proporcione un filtro como propietario, equipo o nombre del área de trabajo, Team Foundation sólo muestra información sobre las áreas de trabajo que ha creado.
Para obtener más información sobre cómo modificar las propiedades de las áreas de trabajo, vea Workspace (Comando).
Para obtener más información sobre cómo buscar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.
Ejemplos
El ejemplo siguiente muestra una lista de todas las áreas de trabajo del usuario actual en el equipo actual.
c:\projects>tf workspaces
En el siguiente ejemplo se muestra la lista de todas las áreas de trabajo de todos los usuarios en todos los equipos creados en la siguiente colección de proyectos de equipo en la dirección http://myserver:8080/tfs/DefaultCollection.
c:\projects>tf workspaces /owner:* /computer:* /collection:http://myserver:8080/tfs/DefaultCollection
En el siguiente ejemplo se muestra información detallada sobre todas las áreas de trabajo que el usuario actual ha creado en la colección de proyectos de equipo en http://myserver:8080/tfs/DefaultCollection de la dirección.
c:\projects>tf workspaces /computer:* /format:detailed /collection:http://myserver:8080/tfs/DefaultCollection
El ejemplo siguiente muestra información detallada que incluye una lista de asignaciones del área de trabajo "WS1", de la que es propietario el usuario actual y que está ubicada en el equipo actual.
c:\projects>tf workspaces /format:detailed /collection:http://myserver:8080/tfs/DefaultCollection WS1
El siguiente ejemplo quita todas las áreas de trabajo almacenadas en la memoria caché de la colección de proyectos de equipo en la dirección http://myserver:8080/tfs/DefaultCollection.
c:\projects>tf workspaces /remove:* /collection:http://myserver:8080/tfs/DefaultCollection
Vea también
Tareas
Crear un archivo de área de trabajo y obtener archivos
Referencia
Sintaxis de la línea de comandos (Control de versiones)
Conceptos
Crear un área de trabajo para trabajar con el proyecto de equipo