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) workspace permite crear, eliminar, ver o modificar propiedades y asignaciones asociadas a un área de trabajo.
Requisitos previos
- Para modificar o eliminar un área de trabajo existente, debe ser el propietario o tener establecido el permiso global Administrar áreas de trabajo en Permitir.
- Para crear un área de trabajo, debe tener el conjunto global de permisos Crear un área de trabajo en Permitir.
- Para crear áreas de trabajo para otros usuarios, debe tener establecido el permiso Administrar áreas de trabajo en Permitir.
Para más información, vea Permisos predeterminados de TFVC.
Sintaxis
tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]
tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]
tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]
Parámetros
En las secciones siguientes se describen los argumentos y las opciones del comando workspace.
Argumentos
| Argument | Descripción |
|---|---|
<workspace-name> |
Especifica un nombre para el área de trabajo sobre la que quiere crear, editar, eliminar o mostrar información. |
<workspace-owner> |
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 está realizando el comando. |
<computer-name> |
Proporciona un valor a la opción /computer. |
<comment> |
Proporciona un valor a la opción /comment. |
@<comment-file> |
Especifica la ruta de acceso de un archivo donde se debe leer el comentario. |
<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. |
<team-project-collection-url> |
Dirección URL de la colección de proyectos que contiene el área de trabajo que quiere crear, editar, eliminar o mostrar información sobre, por ejemplo, https://myserver:8080/tfs/DefaultCollection. |
<owner-name> |
Proporciona un valor a la opción /newowner. |
Opciones
| Opción | Description |
|---|---|
/new |
Crea una nueva área de trabajo. |
/template |
Especifica un área de trabajo existente que se va a usar como plantilla para crear una nueva área de trabajo. El área de trabajo nueva usa las asignaciones del área de trabajo existente. |
/delete |
Elimina el área de trabajo especificada. |
/computer |
Especifica el nombre del equipo en el que se va a crear un á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 |
Realiza el comando del área de trabajo especificada sin mostrar un cuadro de diálogo. |
/collection |
Especifica el nombre de la colección de proyectos. |
/permission |
Especifica las opciones para los permisos del área de trabajo:
Private: solo los propietarios pueden usar, insertar en el repositorio archivos o administrar el área de trabajo.- Public Limited: cualquier usuario válido puede usar el área de trabajo. Pero solo los propietarios pueden insertar en el repositorio archivos o administrar el área de trabajo.- Public: cualquier usuario válido puede usar, insertar en el repositorio archivos o administrar el área de trabajo. |
/location |
Especifica dónde se crea el área de trabajo:
local: en el equipo cliente. Este es el valor predeterminado.- server: en el servidor de Azure DevOps. |
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps. |
/newowner |
Especifica el nombre de usuario para el nuevo propietario del área de trabajo. |
Observaciones
Un área de trabajo es una copia local de los archivos y carpetas del servidor, además de los cambios realizados localmente. Al agregar, editar, eliminar, mover, cambiar el nombre o cambiar cualquier elemento controlado por versiones, los cambios se aíslan en el área de trabajo, donde puede realizar y probar los cambios. Al insertar en el repositorio el trabajo en el código base del equipo, confirma los cambios en el servidor. Están disponibles para otros usuarios que están fuera del á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.
Crear un área de trabajo
Para poder agregar archivos al servidor de control de versiones o desactivar los elementos del servidor, debe crear un área de trabajo o asociar una existente al directorio actual. Para obtener más información, consulte Configuración de Control de versiones de Team Foundation en el equipo de desarrolladores.
Para que el directorio actual sea una carpeta de trabajo para un área de trabajo existente en el equipo, siga estos pasos:
- Escriba
tf workspace <workspace-name>, donde<workspace-name>es el nombre del área de trabajo existente. Aparecerá el cuadro de diálogo Editar área de trabajo. - Seleccione haga clic aquí para escribir una nueva carpeta de trabajo.
- En el cuadro Carpeta de control de código fuente, escriba la ruta de acceso del servidor a la que quiere asignar el directorio actual.
- En el cuadro Carpeta local, escriba el directorio actual.
- Seleccione Aceptar.
Al crear una nueva área de trabajo, puede especificar una plantilla de área de trabajo como parte de la opción /new. Al especificar una plantilla de área de trabajo, TFVC crea una nueva área de trabajo en el equipo actual. TFVC también establece el propietario en el propietario actual y replica las siguientes propiedades de área de trabajo en la nueva área de trabajo desde la plantilla del área de trabajo: mappings y comment. Si no se especifica ningún nombre, el sistema usa un nombre basado en el nombre del equipo actual. Al crear un área de trabajo mediante una plantilla, TFVC no recupera los archivos a los que se asigna desde el servidor. Use el comando get para sincronizar el área de trabajo nueva con la versión más reciente en el servidor. Para obtener más información, vea Obtener comando.
Asignación de una sola carpeta
Solo puede asignar los elementos secundarios inmediatos de una carpeta de control de versiones a un área de trabajo local. Para ello, agregue un carácter comodín asterisco (*) en el cuadro Carpeta de control de código fuente del cuadro de diálogo Agregar área de trabajo, por ejemplo, $/folder/*. De lo contrario, de forma predeterminada, todos los elementos secundarios de la carpeta de control de versiones se asignan de forma recursiva al área de trabajo local.
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 que se descargan en el equipo cliente. Otra manera de limitar los archivos descargados es ocultar los archivos que no es necesario tener en el área de trabajo. Para más información, consulte Optimización del área de trabajo. Este enfoque 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, TFVC cancela los cambios pendientes como parte del proceso de eliminación. La eliminación de un área de trabajo no elimina los archivos y carpetas del equipo cliente que estaban en esa área de trabajo.
Nota:
Los comandos que se ejecutan manualmente requieren la opción /noprompt de omitir la confirmación del usuario. Tenga cuidado si usa el método de PowerShell Start() para ejecutar comandos. La opción /noprompt se puede establecer automáticamente en PowerShell.
Al eliminar un área de trabajo, debe proporcionar <workspace-owner> y <workspace-name>
Puede usar el comando workspace para recuperar esos valores. Para más información, consulte Comando Workspace.
Para encontrar el valor, ejecute el siguiente comando:
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
Para buscar el valor <workspace-name>, use el valor <OwnerId> de la salida del comando anterior como valor <workspace-owner> . Ese valor tiene el formato de un identificador de objeto de Azure Active Directory (Azure AD) seguido de una barra diagonal inversa y un nombre principal de usuario. Use el valor completo. Luego, ejecute el siguiente comando:
c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`
Para eliminar el área de trabajo, ejecute el siguiente comando:
c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`
Edición de un área de trabajo
Puede cambiar los siguientes atributos de área de trabajo:
- Nombre del área de trabajo
- Comentario
- Asignaciones de carpetas de trabajo
Si no se proporciona ninguna especificación del área de trabajo, se usa 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 usar 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:https://myserver:8080/tfs/DefaultCollection
En el ejemplo siguiente se crea un área de trabajo denominada Beta1 y se 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 sobre los permisos de seguridad, vea Permisos predeterminados de TFVC.
c:\projects>tf workspace /new Beta1;jenh
En el ejemplo siguiente se crea una nueva área de trabajo mediante el área de trabajo Beta1 que pertenece a jenh como plantilla:
c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection
En el ejemplo siguiente se quita el área de trabajo Beta1 del servidor:
c:\projects>tf workspace /delete Beta1
En el ejemplo siguiente se editan las propiedades del área de trabajo actual:
c:\projects>tf workspace
En el ejemplo siguiente se abre el área de trabajo Beta1 que pertenece a jenh para que pueda ver sus propiedades y asignaciones. Si tiene el permiso AdminWorkspaces, puede cambiar las propiedades y asignaciones del área de trabajo.
c:\projects> tf workspaces Beta1;jenh