Workspace (Comando)

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)]
 [/collection:TeamProjectCollectionUrl] [/permission:(Private|PublicLimited|Public)][workspacename[;workspaceowner]][/login:username,[password]]

tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner][/login:username,[password]]

tf workspace [/collection:TeamProjectCollectionUrl] [/comment: ("comment"|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]] [/newowner:ownername] [/computer:computername] [/permission:(Private|PublicLimited|Public)] [/login:username,[password]]

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.

username

Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario.

TeamProjectCollectionUrl

La dirección URL de la colección de proyectos de equipo que contiene el área de trabajo sobre la que desea crear, editar, eliminar o mostrar información (por ejemplo, http://myserver:8080/tfs/DefaultCollection).

ownername

Proporciona un valor para la opción /newowner .

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. Esta es una opción avanzada.

/comment

Proporciona un comentario que describe el á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.

/collection

Especifica la colección del proyecto de equipo.

/permission

Especifica las opciones del permiso de área de trabajo:

  • Privado: solo los propietarios pueden usar, administrar el área de trabajo o proteger archivos en ella.

  • Limitado para el público: cualquier usuario válido puede utilizar el área de trabajo. Sin embargo, solo los propietarios pueden administrar el área de trabajo o proteger archivos en ella.

  • Público: cualquier usuario válido puede utilizar, administrar el área de trabajo o proteger archivos en ella.

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server.

/newowner

Especifica el nombre de usuario del nuevo propietario del área de trabajo.

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 buscar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.

Crear un á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 Crear un archivo de área de trabajo y obtener archivos.

Para convertir el directorio actual en una carpeta de trabajo de un área de trabajo existente en el equipo, escriba tf workspace workspacename, 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 Get (Comando) 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 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 /collection:http://myserver:8080/tfs/DefaultCollection

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 /collection:http://myserver:8080/tfs/DefaultCollection

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

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

Crear un archivo de área de trabajo y obtener archivos

Esconder y mostrar carpetas en un área de trabajo

Referencia

Sintaxis de la línea de comandos (Control de versiones)

Workspaces (Comando)

Conceptos

Crear un área de trabajo para trabajar con el proyecto de equipo

Otros recursos

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