Administrar tipos de vínculos [witadmin]
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 Vincular elementos de trabajo para admitir 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 enlace 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: Enumera el conjunto de tipos de vínculos disponible en un servidor.
reactivatelinktype: Reactiva el tipo de vínculo especificado y opcionalmente le asigna un nombre nuevo.
Para ejecutar la herramienta de la línea de comandos witadmin, abra una ventana de símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:
cd %programfiles(x86)%\Microsoft Visual Studio 12.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 obtener más información, vea Referencia de permisos para Team Foundation Server.
.gif "Nota") 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 más información sobre 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 LinksControlOptions (Elementos).
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
Vincular elementos de trabajo para admitir rastreabilidad
witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo