Comando workfold (Control de versiones de Team Foundation)

  • Artículo

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 donde se recuperan todos los archivos y subcarpetas de la carpeta de Azure DevOps Server cuando se ejecuta una operación tfget. 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