Compartir a través de


Comando workspace

Actualización: noviembre 2007

Permite crear, eliminar, ver o modificar las propiedades y asignaciones asociadas a un área de trabajo.

Permisos necesarios

Para modificar o eliminar un área de trabajo existente, debe ser su propietario o debe tener el permiso global Administrar áreas de trabajo establecido en Permitir. Para crear un área de trabajo, debe tener el permiso global Crear un área de trabajo establecido en Permitir. Para crear áreas de trabajo para otros usuarios, debe tener el permiso Administrar áreas de trabajo establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.

tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
 [/computer:computername] [/comment:(“comment”|@comment file)]
 [/s:servername] [workspacename[;workspaceowner]]

tf workspace /delete [/server:servername] workspacename[;workspaceowner]

tf workspace [/server:servername] [/comment: (“comment”|@comment file)] [/newname:workspacename]
 [workspacename[;workspaceowner]]

Parámetros

Argumento

Descripción

workspacename

Especifica un nombre para el área de trabajo cuya información se va a crear, editar, eliminar o mostrar.

workspaceowner

Especifica un nombre de usuario para el área de trabajo. Este parámetro es necesario cuando el propietario del área de trabajo no es la persona que ejecuta el comando.

computername

Proporciona un valor para la opción /computer .

comment

Proporciona un valor para la opción /comment .

@commentfile

Especifica la ruta de acceso de un archivo donde se debería leer el comentario.

servername

Valor proporcionado por el usuario para la opción /server. Por ejemplo, teamfoundation2.

Opción

Descripción

/new

Crea una nueva área de trabajo.

/template

Especifica un área de trabajo existente que se utilizará como plantilla para crear la nueva área de trabajo. La nueva área de trabajo utiliza las asignaciones del área de trabajo existentes.

/delete

Elimina el área de trabajo especificada.

/computer

Especifica el nombre del equipo en el que se creará el área de trabajo. Ésta es una opción avanzada.

/comment

Proporciona un comentario que describe el área de trabajo.

/server

Identifica Team Foundation Server. Esta opción se requiere cuando crea una nueva área de trabajo y cuando intenta iniciar el comando workspace desde un directorio no asignado a un área de trabajo.

/newname

Cambia el nombre de un área de trabajo existente.

/noprompt

Ejecuta el comando de área de trabajo especificado sin mostrar un cuadro de diálogo.

Comentarios

Un área de trabajo es una copia local de los archivos y carpetas en el servidor, además de todos los cambios que haya realizado localmente. Cuando agrega, edita, elimina, mueve, cambia de nombre o modifica de algún modo un elemento con control de versiones, sus cambios se aíslan en el área de trabajo, donde puede realizar y probar los cambios. Sus cambios pendientes se confirman en el servidor y se ponen a disposición de otros usuarios fuera de su área de trabajo cuando realiza una protección.

Para obtener más información sobre cómo encontrar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.

Crear una nueva área de trabajo

Para poder agregar archivos al servidor de control de versiones o desproteger los elementos en el servidor para editarlos, debe crear un área de trabajo o asociar una existente al directorio actual. Para obtener más información, vea Cómo: Crear un área de trabajo asignada.

Para convertir el directorio actual en una carpeta de trabajo de un área de trabajo existente en el equipo, escriba tf workspaceworkspacename, donde workspacename es el nombre del área de trabajo existente. Aparecerá el cuadro de diálogo Editar el área de trabajo. Haga clic en Haga clic aquí para especificar una nueva carpeta de trabajo, escriba la ruta de acceso del servidor al que desea asignar el directorio actual en el cuadro Carpeta de control de código fuente , escriba el directorio actual en el cuadro Carpeta local y haga clic en Aceptar.

Cuando crea una nueva área de trabajo, puede especificar un área de trabajo de plantilla como parte de la opción /new . Cuando especifica un área de trabajo de plantilla, Team Foundation crea una nueva área de trabajo en el equipo actual, establece el propietario como el propietario actual y replica las propiedades de área de trabajo siguientes en la nueva área de trabajo desde el área de trabajo de plantilla: asignaciones y comentario. Si no se especifica ningún nombre, el sistema utiliza un nombre basado en el nombre del equipo actual. Cuando crea un área de trabajo mediante una plantilla, Team Foundation no recupera los archivos a los que se asigna desde el servidor. Utilice el Comando get para sincronizar la nueva área de trabajo con la última versión en el servidor.

Asignación de una sola carpeta

Puede elegir asignar sólo los elementos secundarios inmediatos de una carpeta con control de versiones a un área de trabajo local. Para ello, agregue un carácter comodín de asterisco en el cuadro Carpeta de control de código fuente en el cuadro de diálogo Agregar área de trabajo. Por ejemplo, $/carpeta/*. De lo contrario, todos los elementos secundarios de la carpeta con control de versiones se asignan de forma recursiva al área de trabajo local de forma predeterminada.

La asignación de una sola carpeta dentro de una jerarquía de control de versiones es útil porque limita el número de elementos descargados en el equipo cliente. Otra manera de limitar los archivos descargados consiste en esconder los archivos que no necesita tener en el área de trabajo. Para obtener más información, vea Cómo: Esconder y mostrar carpetas en un área de trabajo. Esto proporciona tiempos de descarga más rápidos y ahorra espacio en disco en el equipo cliente.

Eliminar un área de trabajo

Si elimina un área de trabajo que contiene cambios pendientes, Team Foundation cancela los cambios pendientes como parte del proceso de eliminación. Al eliminar un área de trabajo, no se eliminan los archivos y carpetas en el equipo cliente que estaba en esa área de trabajo.

Editar un área de trabajo

Puede cambiar los siguientes atributos del área de trabajo:

  • Nombre del área de trabajo

  • Comentarios

  • Asignaciones de carpeta de trabajo

Si no se proporciona ninguna especificación del área de trabajo, se utiliza el área de trabajo de la carpeta actual.

Ejemplos

En el ejemplo siguiente se abre el cuadro de diálogo Agregar área de trabajo y se crea una nueva área de trabajo. Puede utilizar el cuadro de diálogo Agregar área de trabajo para editar la carpeta de control de código fuente, el propietario, el equipo, el comentario y las carpetas locales.

c:\projects>tf workspace /new /server:teamserver2

El ejemplo siguiente crea una nueva área de trabajo denominada Beta1 y asigna jenh como propietario del área de trabajo. Debe tener el permiso AdminWorkspaces para asignar la propiedad de una nueva área de trabajo a otro usuario. Para obtener más información acerca de los permisos de seguridad, vea Permisos de Team Foundation Server.

c:\projects>tf workspace /new Beta1;jenh

El ejemplo siguiente crea una nueva área de trabajo utilizando el área de trabajo Beta1 cuyo propietario es jenh como plantilla.

c:\projects>tf workspace /new /template:Beta1;jenh /server:teamserver2

El ejemplo siguiente quita el área de trabajo Beta1 del sistema.

c:\projects>tf workspace /delete Beta1

El ejemplo siguiente edita las propiedades del área de trabajo actual.

c:\projects>tf workspace

El ejemplo siguiente abre el área de trabajo Beta1, cuyo propietario es el usuario jenh, para que pueda ver sus propiedades y asignaciones. Si tiene permisos AdminWorkspaces, puede cambiar las propiedades y asignaciones del área de trabajo.

c:\projects> tf workspace Beta1;jenh

Vea también

Tareas

Tutorial: Trabajar con el control de versiones de Team Foundation desde la línea de comandos

Cómo: Crear un área de trabajo asignada

Cómo: Esconder y mostrar carpetas en un área de trabajo

Conceptos

Trabajar con espacios de trabajo del control de versiones

Referencia

Sintaxis de la línea de comandos (Team System)

Comando workspaces

Otros recursos

Comandos de la utilidad Tf de la línea de comandos