Compartir a través de

Comando Workspaces (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 de 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 nombre de usuario o un cambio de nombre de equipo en un servidor de Azure DevOps.

Prerrequisitos

Para usar el comando workspaces, tenga el permiso Read establecido en Permitir. Para obtener más información, consulte 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

de argumentos de

descripción

<owner-name>

Proporciona un valor a la opción /owner. Use una cadena vacía ("") para buscar coincidencias con á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 áreas de trabajo en 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 antiguo para la opción /updateUserName.

<old-computer-name>

Proporciona el nombre de equipo antiguo 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 las que desea 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

de opción de

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. Brief es el valor predeterminado.

/updateUserName

Actualiza la información de identificación de seguridad en el servidor de Azure DevOps para un usuario cuyo nombre de usuario de red se ha cambiado. 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 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 específico de Azure DevOps. 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 Workspace.

Para obtener más información sobre cómo usar la utilidad de línea de comandos de tf, consulte Usar comandos de control de versiones de Team Foundation.

Ejemplos

En el ejemplo siguiente se muestra una lista de todas las áreas de trabajo para el 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