Workfold (Comando)
Crea, modifica o muestra información sobre las asignaciones entre sus carpetas de área de trabajo y las carpetas del servidor de control de versiones de Team Foundation.
Permisos necesarios
Para utilizar el comando workfold, debe ser el propietario del área de trabajo especificada o implícita, o debe tener el permiso global Administrar áreas de trabajo establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.
tf workfold localfolder [/login:username,[password]]
tf workfold [/workspace:workspacename] [/login:username,[password]]
tf workfold [/collection:TeamProjectCollectionUrl] [/workspace:workspacename] [/login:username,[password]]
serverfolder
tf workfold [/map serverfolder localfolder] [/collection:TeamProjectCollectionUrl]
[/workspace:workspacename][/login:username,[password]
tf workfold /unmap [/collection:TeamProjectCollectionUrl] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder) [/login:username,[password]]
tf workfold /cloak
serverfolder [/workspace:workspacename] [/collection:TeamProjectCollectionUrl] [/login:username,[password]]
tf workfold /decloak serverfolder
[/workspace:workspacename] [/collection:TeamProjectCollectionUrl][/login:username,[password]]
Parámetros
Argumento |
Descripción |
|---|---|
workspacename |
Especifica el nombre del área de trabajo en la que opera el comando para la opción /workspace. |
serverfolder |
Especifica el nombre de una carpeta del servidor control de versiones de Team Foundation. |
localfolder |
Especifica el nombre de una carpeta local. |
TeamProjectCollectionUrl |
La dirección URL de la colección de proyectos de equipo que contiene las carpetas que desea comparar con las carpetas de servidor (por ejemplo, http://myserver:8080/tfs/DefaultCollection/). |
nombre de usuario |
Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario. |
Opción |
Descripción |
|---|---|
/workspace |
Especifica el nombre del área de trabajo en la que desea trabajar. |
/map |
Especifica una asociación entre una carpeta local y la carpeta del servidor control de versiones de Team Foundation. De forma predeterminada, el comando workfold utiliza esta opción aunque no se especifique, a menos que se especifique /unmap, /cloak o /decloak. |
/unmap |
Especifica qué asignación de carpetas se debe quitar del área de trabajo. |
/cloak |
Especifica que la carpeta se debe excluir de cualquier operación de control de versiones realizada en el área de trabajo. |
/decloak |
Muestra una carpeta para que se pueda recuperar en el área de trabajo. |
/collection |
Especifica la colección del proyecto de equipo. |
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server. |
Comentarios
Puede emplear el comando workfold de la utilidad de línea de comandos tf para crear y editar las asignaciones de área de trabajo. Una asignación de área de trabajo crea una carpeta en el cliente en la que se recuperan todos los archivos y subcarpetas de la carpeta de servidor de control de versiones de Team Foundation al ejecutar una operación tf get. get no funcionará si la carpeta del cliente está escondida.
También puede especificar un carácter comodín de asterisco (*) para asignar una carpeta de Team Foundation Server y sus elementos inmediatos al área de trabajo local. Esta operación recibe el nombre de asignación de carpeta única.
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.
Opciones para la asignación de área de trabajo
Una asignación de área de trabajo es una lista de elementos activos y escondidos. Puede agregar elementos del servidor control de versiones de Team Foundation a la lista asignada en el área de trabajo utilizando la opción /map. También puede excluir explícitamente un elemento del área de trabajo utilizando la opción /cloak. Sólo puede esconder los elementos que tienen un elemento primario asignado. Esconder es una manera eficaz de aumentar la velocidad de operaciones Get por lotes y de conservar espacio en disco.
Utilice la operación de esconder con prudencia. Para evitar los problemas de compilación e integración, sólo debe esconder los elementos que sabe que están fuera del ámbito de sus proyectos actuales y futuros, como archivos de imágenes y de documentación externa.
Puede utilizar las opciones /unmap y /decloak para eliminar selectivamente las entradas asignadas y escondidas de la asignación del área de trabajo.
Cómo se aplican las asignaciones de área de trabajo
De forma predeterminada, las asignaciones de área de trabajo se aplican de forma recursiva. Cuando asigna una carpeta local a una carpeta de servidor de control de versiones de Team Foundation, el sistema crea implícitamente una asignación entre todas sus subcarpetas actuales y futuras. Por ejemplo, si asigna $/projects a c:\projects, luego agrega un proyecto denominado $/projects/project_one y ejecuta una operación get del área de trabajo, Team Foundation crea automáticamente una carpeta de trabajo local denominada project_one en el directorio C:\projects.
En este ejemplo, puede utilizar un carácter comodín, "*", para asignar una carpeta de servidor y sus elementos inmediatos al área de trabajo local:
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
En este ejemplo, puede reemplazar la asignación creada automáticamente entre $/projects/project_one y C:\projects\project_one utilizando el comando workfold de la forma siguiente:
tf workfold $/projects/project_one C:\DifferentWorkfold
Asignaciones en carpetas escondidas
Se pueden realizar asignaciones de carpetas visibles que se muestran debajo de una carpeta escondida en la jerarquía del control de versiones en el área de trabajo local.
Ejemplos
El ejemplo siguiente muestra las asignaciones del área de trabajo donde c:\projects reside.
c:\projects>tf workfold
El ejemplo siguiente esconde la carpeta c:\projects\lib.
c:\projects>tf workfold /cloak c:\projects\lib
El ejemplo siguiente muestra la asignación del archivo local word.cs.
c:\projects>tf workfold word.cs
En el ejemplo siguiente se asigna la carpeta C:\DifferentWorkfold a la carpeta de servidor de control de versiones de Team Foundation $/proyectos/project_one y se reemplaza la asignación de área de trabajo anterior de dicha carpeta.
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold
Vea también
Tareas
Esconder y mostrar carpetas en un área de trabajo
Crear un archivo de área de trabajo y obtener archivos
Referencia
Sintaxis de la línea de comandos (Control de versiones)
Conceptos
Crear un área de trabajo para trabajar con el proyecto de equipo