Compartir a través de

Administrar tipos de vínculos [witadmin]

  • Artículo

Puede definir y modificar tipos de vínculo personalizados, parecido a como con los tipos de elemento de trabajo. Sin embargo, no puede realizar ningún cambio en tipos de vínculo definidos por el sistema. Antes de añadir un nuevo tipo de vínculo a la colección de proyectos de equipo, repase los tipos de vínculo disponibles para su uso. Vea Administrar dependencias, vincular elementos de trabajo para admitir la rastreabilidad.

Puede administrar los tipos de vínculo definidos para cada colección de proyectos de equipo usando los siguientes comandos de witadmin:

  • deactivatelinktype: Desactiva el tipo de vínculo especificado. Los usuarios ya no podrán crear vínculos de este tipo. Los vínculos de este tipo existentes seguirán funcionando correctamente.

  • deletelinktype: Quita el tipo de vínculo especificado de la base de datos permanentemente. Todos los vínculos definidos con este tipo de enlace también se quitarán.

  • exportlinktype: Exporta las definiciones de tipos de vínculo. Puede exportar la definición de un tipo de vínculo único o todos los tipos de vínculo definidos para el servidor.

  • importlinktype: Importa las definiciones de tipos de vínculo de un archivo XML. Si ya existe un tipo de vínculo con el mismo nombre de referencia, se actualizará para que coincida con el tipo de vínculo importado. Si el tipo de vínculo todavía no existe, se creará un nuevo tipo de vínculo.

  • listlinktypes: Muestra el conjunto de tipos de vínculos disponibles en un servidor.

  • reactivatelinktype: Reactiva el tipo de vínculo especificado y opcionalmente le asigna un nombre nuevo.

La herramienta de línea de comandos witadmin solo funciona cuando se ejecuta en una implementación local de TFS. Para ejecutar la herramienta, abra una ventana del símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

En una edición de 32 bits de Windows, reemplace %programfiles(x86)% por %programfiles%.

Requisitos

Para la colección del proyecto de equipo donde se definen los tipos de vínculo, debe tener establecidos los siguientes permisos:

  • Para enumerar o exportar los tipos de vínculo, debe tener el permiso Ver información del nivel de proyecto para un proyecto de equipo de la colección establecido en Permitir.

  • Para eliminar, importar o reactivar tipos de vínculo, debe ser miembro del grupo de seguridad Administradores de la colección de proyectos o tener el permiso Administrar tipos de vínculo de los elementos de trabajo establecido en Permitir.

Para más información, vea Referencia de permisos para Team Foundation Server.

Nota

Incluso si ha iniciado sesión con permisos administrativos, debe abrir una ventana de símbolo del sistema con privilegios elevados para ejecutar esta función en un servidor que ejecute Windows Server 2008.Para abrir una ventana del símbolo del sistema con privilegios elevados, elija Inicio, abra el menú contextual de Símbolo del sistema y, a continuación, elija Ejecutar como administrador.Para obtener más información, vea el sitio web de Microsoft: Control de cuentas de usuario.

witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

Parámetros

Parámetro

Descripción

/collection:CollectionURL

Especifica el URI de la colección de proyectos de equipo. El formato del URI es el siguiente: http://NombreDeServidor:Puerto/NombreDeDirectorioVirtual/NombreDeColección

Por ejemplo:

http://nombreDeServidor:8080/tfs/Colección0

Si no se usa ningún directorio virtual, el formato del identificador URI será el siguiente:

http://NombreDeServidor:Puerto/NombreDeColección

/n: LinkName

El nombre o el nombre de referencia del tipo de vínculo que hay que desactivar o eliminar.

/f: FileName

El archivo XML de los tipos de vínculo. Necesario para importar, opcional para exportar. Si omite este parámetro, la salida del comando aparece en la pantalla.

/e: encoding

El nombre de un formato de codificación de .NET Framework 2.0. La codificación especificada se usará para exportar o importar los datos XML. Por ejemplo, /e:utf-7 especifica la codificación Unicode (UTF-7). Si se omite este parámetro, witadmin intenta detectar la codificación y, en caso de no poder detectarla, witadmin usa UTF-8.

/v

Valida el tipo de vínculo XML sin importarlo.

/noprompt

Inhabilita la solicitud de confirmación.

/? o help

Muestra ayuda sobre el comando en la ventana del símbolo del sistema.

Comentarios

Para la estructura del esquema de definición del tipo de vínculo, vea Referencia de elemento de tipo de vínculo.

Para obtener información acerca de cómo puede restringir los tipos de relaciones de vínculo que pueden hacer los miembros del equipo, vea Referencia de campos, controles y restricciones de vínculos y Elementos LinksControlOptions.

Ejemplos

A menos que se especifique lo contrario, se aplican los siguientes valores en cada ejemplo:

  • URI para la colección de proyectos de equipo: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Nombre del servidor: AdventureWorksServer

  • Nombre del archivo de entrada o salida: myLinkTypes.xml

  • Nombre de tipo de vínculo: mylinktype

  • Codificación predeterminada: UTF-8

Enumera los tipo de vínculos

El comando siguiente muestra los tipos de vínculo personalizados definidos para AdventureWorksServer de Team Foundation.

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Enumera la definición de tipo de vínculo

En el siguiente ejemplo se muestra la definición del tipo de vínculo en una ventana de símbolo del sistema:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Desactivar y después reactivar un tipo de vínculo

Los ejemplos siguientes desactivan el tipo de vínculo, mylinktype, y después lo reactivan:

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

Exporta la definición de tipo de vínculo

El siguiente comando exporta la definición de todos los tipos de vínculo del archivo, mylinktype.xml:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Importa la definición de tipos de vínculo

En el siguiente ejemplo se importa la definición de los tipos de vínculo definidos en el archivo XML:

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Vea también

Conceptos

Referencia de elemento de tipo de vínculo

Referencia de campos, controles y restricciones de vínculos

Otros recursos

Administrar dependencias, vincular elementos de trabajo para admitir la rastreabilidad

witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo