Compartir a través de

Comando Workspace (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 Control de versiones de Team Foundation (TFVC) workspace proporciona una manera de crear, eliminar, ver o modificar propiedades y asignaciones asociadas a un área de trabajo.

Prerrequisitos

  • Para modificar o eliminar un área de trabajo existente, sea el propietario o tenga el permiso global Administrar áreas de trabajo establecido en Permitir.
  • Para crear un área de trabajo, tenga establecido el permiso global Crear un área de trabajo en Permitir.
  • Para crear áreas de trabajo para otros usuarios, tenga el permiso Administrar áreas de trabajo de establecido en Permitir.

Para obtener más información, consulte 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

Argumento Descripción
<workspace-name> Especifica un nombre para el área de trabajo sobre la que desea 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 desea 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 Descripción
/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 nuevo área de trabajo 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 opción 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 la colección de proyectos.
/permission Especifica las opciones para los permisos del área de trabajo:

    - Private: solo los propietarios pueden usar, proteger archivos en o administrar el área de trabajo.


    - Public Limited: cualquier usuario válido puede usar el área de trabajo. Pero solo los propietarios pueden proteger archivos en o administrar el área de trabajo.


    - Public: cualquier usuario válido puede usar, proteger archivos en o administrar el área de trabajo.
/location Especifica dónde se crea el área de trabajo:

    - local: en el equipo cliente. Este valor 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

Una área de trabajo es una copia local de los archivos y carpetas en el 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 están aislados en el área de trabajo, donde puede realizar y probar los cambios. Cuando proteger 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 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.

Creación de un área de trabajo

Para poder agregar archivos al servidor de control de versiones o desactive los elementos del servidor, debe crear un área de trabajo o asociar uno existente al directorio actual. Para obtener más información, consulte Set up Team Foundation Version Control on your dev machine.

Para que el directorio actual sea una carpeta de trabajo para un área de trabajo existente en el equipo, siga estos pasos:

  1. Escriba tf workspace <workspace-name>, donde <workspace-name> es el nombre del área de trabajo existente. Aparece el cuadro de diálogo Editar área de trabajo .
  2. Seleccione haga clic aquí para escribir una nueva carpeta de trabajo.
  3. En el cuadro carpeta de control de código fuente, escriba la ruta de acceso del servidor a la que desea asignar el directorio actual.
  4. En el cuadro carpeta local, escriba el directorio actual.
  5. Seleccione Aceptar.

Al crear un área de trabajo, puede especificar un área de trabajo de plantilla de como parte de la opción /new. Al especificar un área de trabajo de plantilla, 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 del área de trabajo en el área de trabajo nueva desde el área de trabajo de plantilla: 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 nuevo área de trabajo con la versión más reciente en el servidor. Para obtener más información, vea comando Get.

Asignación de carpetas únicas

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, . De lo contrario, de forma predeterminada, todos los elementos secundarios de la carpeta de control de versiones se asignan recursivamente 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 obtener más información, consulte Optimizar el área de trabajo. Este enfoque proporciona tiempos de descarga más rápidos y ahorra espacio en disco en el equipo cliente.

Eliminación de 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 para omitir la confirmación del usuario. Tenga cuidado si usa el método Start() de PowerShell para ejecutar comandos. La opción /noprompt se puede establecer automáticamente en PowerShell.

Al eliminar un área de trabajo, debe proporcionar el <workspace-owner> y <workspace-name>

Puede usar el comando workspace para recuperar esos valores. Para obtener más información, consulte comando workspaces. Para buscar el valor de <workspace-owner>, ejecute el siguiente comando:

c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml

Para buscar el valor de <workspace-name>, use el valor <OwnerId> de la salida del comando anterior como valor de <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 todo el valor. A continuación, 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. Tener los AdminWorkspaces permiso para asignar la propiedad de una nueva área de trabajo a otro usuario. Para obtener más información sobre los permisos de seguridad, consulte permisos predeterminados de TFVC.

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

En el ejemplo siguiente se crea un área de trabajo con el área de trabajo beta1 de 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 de 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 de Beta1 propiedad de 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