Comando del área de trabajo (Control de versiones de Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
El comando Control de versiones de Team Foundation (TFVC) workspaces muestra información sobre las áreas de trabajo del sistema y actualiza la información almacenada en caché sobre un cambio de nombre de usuario o nombre de equipo en un servidor de Azure DevOps.
Requisitos previos
Para usar el comando workspaces, debe tener el permiso Lectura establecido en Permitir. Para más información, vea Permisos predeterminados de TFVC.
Sintaxis
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
Parámetros
En las secciones siguientes se describen los argumentos y las opciones del comando workspaces.
Argumentos
Argument
Descripción
<owner-name>
Proporciona un valor a la opción /owner. Use una cadena vacía ("") para buscar coincidencias con las áreas de trabajo creadas por cualquier usuario.
<computer-name>
Proporciona un valor a la opción /computer. Use una cadena vacía ("") para buscar coincidencias con las áreas de trabajo de cualquier equipo.
<workspace-name>
Especifica el nombre de un área de trabajo sobre la que se va a mostrar información. Si no se especifica un valor, se muestra información sobre todas las áreas de trabajo de un servidor. También puede usar un carácter comodín asterisco (*) para mostrar información sobre todas las áreas de trabajo de un servidor.
<old-user-name>
Proporciona el nombre de usuario anterior para la opción /updateUserName.
<old-computer-name>
Proporciona el nombre de equipo anterior para la opción /updateComputerName.
<team-project-collection-url>
Dirección URL de la colección de proyectos que contiene las áreas de trabajo sobre los que quiere mostrar información, por ejemplo, https://myserver:8080/tfs/DefaultCollection.
<username>
Proporciona un valor a la opción /login. Puede especificar este valor como DOMAIN\<username> o <username>.
<password>
Proporciona un valor a la opción /login.
Opciones
Opción
Descripción
/owner
Especifica el nombre del usuario que creó el área de trabajo. Si no se especifica ningún propietario, TFVC devuelve información sobre las áreas de trabajo que pertenecen solo al usuario actual.
/computer
Especifica el nombre de un equipo cliente por el que se va a filtrar la lista de áreas de trabajo del servidor. Si no se especifica ningún equipo, TFVC devuelve información sobre las áreas de trabajo solo en el 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. Xml devuelve información del área de trabajo, una asignación, la fecha de acceso más reciente y también los alias de propietario. El formato detallado solo se puede usar cuando se especifica la opción /collection. El valor predeterminado es Brief.
/updateUserName
Actualiza la información de identificación de seguridad en el servidor Azure DevOps para un usuario cuyo nombre de usuario de red se ha modificado. Si especifica esta opción, también debe especificar una colección de proyectos mediante la opción /collection.
/updateComputerName
Indica a TFVC que actualice sus tablas para reflejar un cambio en el nombre de un equipo cliente. Si especifica esta opción, también debe especificar una colección de proyectos mediante la opción /collection.
/remove
Quita las entradas del área de trabajo especificadas para la colección de proyectos especificada de la memoria caché del cliente.
/collection
Especifica el nombre de la colección de proyectos.
/login
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps Server.
Observaciones
El comando workspaces de la utilidad de línea de comandos tf muestra información sobre áreas de trabajo en el equipo actual, propiedad de un usuario especificado, o para todas las áreas de trabajo asociadas a un servidor Azure DevOps específico. Para cada área de trabajo, TFVC muestra el nombre, el propietario, el comentario y el nombre del equipo. Con la salida detallada, también muestra las asignaciones del área de trabajo. A menos que proporcione un filtro como el propietario, el equipo o el nombre del área de trabajo, TFVC solo muestra información sobre las áreas de trabajo que ha creado.
Para obtener más información sobre cómo editar las propiedades del área de trabajo, consulte Comando área de trabajo.
Para más información sobre cómo usar la utilidad de línea de comandos tf, vea Uso de comandos de control de versiones de Team Foundation.
Ejemplos
En el ejemplo siguiente se muestra una lista de todas las áreas de trabajo del usuario actual en el equipo actual:
c:\projects>tf workspaces
En el ejemplo siguiente se muestra una lista de todas las áreas de trabajo de todos los usuarios de todos los equipos que se han creado en la siguiente colección de proyectos en la dirección https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
En el ejemplo siguiente se muestra información detallada sobre todas las áreas de trabajo que el usuario actual ha creado en la colección de proyectos en la dirección https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
En el ejemplo siguiente se muestra información detallada sobre el área de trabajo WS1, que es propiedad del usuario actual y se encuentra en el equipo actual. La información mostrada incluye una lista de asignaciones de áreas de trabajo.
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
En el ejemplo siguiente se quitan todas las áreas de trabajo almacenadas en caché de la memoria caché de la colección de proyectos en la dirección https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection