Comando workfold (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 workfold del Control de versiones de Team Foundation (TFVC) crea, modifica o muestra información sobre las asignaciones entre las carpetas del área de trabajo y las carpetas que se encuentran en Azure DevOps Server para TFVC.
Requisitos previos
Para usar el comando workfold, debe ser propietario del área de trabajo especificada o implícita, o bien tener el permiso global Administrar áreas de trabajo establecido en Permitir. Para obtener más información, vea Permisos de TFVC predeterminados.
Sintaxis
tf workfold <local-folder> [/login:<username>,[<password>]]
tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]
tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>
tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>]
[/workspace:<workspace-name>][/login:<username>,[<password>]
tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>]
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]
tf workfold /cloak
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]
tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]
Parámetros
En las secciones siguientes se describen los argumentos y las opciones del comando workfold.
Argumentos
Argument
Descripción
<workspace-name>
Especifica el nombre del área de trabajo donde el comando opera con la opción /workspace.
<server-folder>
Especifica el nombre de una carpeta de Azure DevOps Server.
<local-folder>
Especifica el nombre de una carpeta local.
<team-project-collection-url>
Dirección URL de la colección de proyectos que contiene las carpetas que quiere comparar con las carpetas del servidor, por ejemplo, https://myserver:8080/tfs/DefaultCollection/.
<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.
Opciones
Opción
Descripción
/workspace
Especifica el nombre del área de trabajo donde se va a trabajar.
/map
Especifica una asociación entre una carpeta local y la carpeta de Azure DevOps Server. El comando workfold usa esta opción de forma predeterminada, incluso si no se especifica, a menos que se especifique /unmap, /cloako /decloak.
/unmap
Especifica la asignación de carpetas que se va a quitar del área de trabajo.
/cloak
Especifica que la carpeta debe excluirse de cualquier acción de control de versiones que se realice en el área de trabajo.
/decloak
Muestra una carpeta para poder recuperarla en el área de trabajo.
/collection
Especifica la colección de proyectos.
/login
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps.
Observaciones
Puede usar el comando workfold de la utilidad de línea de comandos tf para crear y editar asignaciones de áreas de trabajo. Una asignación de área de trabajo crea una carpeta del lado cliente en la que se recuperan todos los archivos y subcarpetas de la carpeta del servidor de Azure DevOps al ejecutar una tf get operación. La operación get no funciona si la carpeta del lado cliente está escondida.
También se puede usar un carácter comodín de asterisco (*) para asignar una carpeta de Azure DevOps Server y sus elementos inmediatos al área de trabajo local. Esta asignación se suele conocer como asignación de carpeta única.
Para obtener 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.
Opciones de asignación de área de trabajo
Una asignación de área de trabajo es una lista de elementos activos y escondidos. Puede agregar elementos de Azure DevOps Server a la lista asignada en el área de trabajo mediante la opción /map. Un elemento del área de trabajo se puede excluir explícitamente también mediante la opción /cloak. Solo se pueden esconder elementos que tienen un elemento primario asignado. Esconderlos es una forma eficaz de mejorar la velocidad de las operaciones get por lotes y de ahorrar espacio en el disco.
Esconda elementos con discreción. Para evitar problemas de compilación e integración, conviene esconder solo aquellos elementos que se sabe están fuera del ámbito de los proyectos actuales y futuros, como imágenes y archivos de documentación externos.
Puede usar las opciones /unmap y /decloak para eliminar de forma selectiva entradas asignadas y escondidas de la asignación del área de trabajo.
Cómo se aplican las asignaciones de área de trabajo
Las asignaciones de áreas de trabajo se aplican recursivamente de forma predeterminada. Al asignar una carpeta local a una carpeta de Azure DevOps Server, el sistema crea implícitamente una asignación entre todas sus subcarpetas actuales y futuras.
Por ejemplo, supongamos que asignamos $/projects a C:\projects. Luego, agregamos un proyecto llamado $/projects/project_one y ejecutamos el comando get en el área de trabajo. En este escenario, TFVC crea automáticamente una carpeta de trabajo local denominada project_one en el directorio C:\projects.
En el siguiente ejemplo se usa un carácter comodín de asterisco (*) para asignar una carpeta de servidor y sus elementos inmediatos al área de trabajo local.
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
En el siguiente ejemplo se usa el comando workfold para invalidar la asignación que se crea automáticamente entre $/projects/project_one y C:\projects\project_one:
tf workfold $/projects/project_one C:\DifferentWorkfold
Asignaciones con carpetas escondidas
Las carpetas no escondidas que están dentro de una carpeta escondida en la jerarquía de control de versiones se pueden asignar al área de trabajo local.
Ejemplos
En el siguiente ejemplo se muestran las asignaciones del área de trabajo en la que residen en c:\projects:
c:\projects>tf workfold
En el siguiente ejemplo se esconde la carpeta c:\projects\lib:
c:\projects>tf workfold /cloak c:\projects\lib
En el siguiente ejemplo se muestra la asignación del archivo local word.cs:
c:\projects>tf workfold word.cs
En el siguiente ejemplo se asigna la carpeta C:\DifferentWorkfold a la carpeta de Azure DevOps Server $/projects/project_one y se reemplaza la asignación de área de trabajo anterior por la carpeta de Azure DevOps Server $/projects/project_one:
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold