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)