Personalizar y administrar tipos de vínculo

Artículo
08/10/2011

Puede administrar los tipos de vínculo definidos para una colección de proyectos de equipo mediante los siguientes comandos 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 continuarán funcionando correctamente.
deletelinktype: quita permanentemente el tipo de vínculo especificado de la base de datos. También se quitan todos los vínculos definidos con este tipo de vínculo.
exportlinktype: exporta las definiciones de tipos de vínculo. Puede exportar la definición de un único tipo de vínculo o de todos los tipos de vínculo definidos para el servidor.
importlinktype: importa las definiciones de los tipos de vínculo de un archivo XML. Si un tipo de vínculo con el mismo nombre de referencia ya existe, se actualizará para coincidir con el tipo de vínculo importado. Si el tipo de vínculo aún no existe, se creará un nuevo tipo de vínculo.
listlinktypes: enumera el conjunto de tipos de vínculo disponibles en un servidor.
reactivatelinktype: reactiva el tipo de vínculo especificado, y opcionalmente le asigna un nuevo nombre.

La utilidad de línea de comandos witadmin se encuentra en Unidad::\Archivos de programa\Microsoft Visual Studio 10.0\Common7\IDE en el equipo cliente que ejecuta Team Explorer.

Nota

Puede crear y modificar tipos de vínculo utilizando el Editor de procesos, una herramienta avanzada de Visual Studio. No se ofrece soporte técnico para esta herramienta. Para obtener más información, vea la página siguiente en el sitio web de Microsoft: Team Foundation Server Power Tools April 2010.

Permisos necesarios

Para la colección de proyectos en la que se definen los tipos de vínculo, debe tener los siguientes permisos establecidos:

Para exportar o enumerar tipos de vínculo, deberá ser miembro del grupo Lectores o tener el permiso Ver los elementos de trabajo en este nodo establecido en Permitir.
Para eliminar, importar o reactivar tipos de vínculo, debe ser miembro del grupo de seguridad Administradores de Team Foundation o del grupo de seguridad Administradores del proyecto.

Para obtener más información, vea Permisos de Team Foundation Server y Grupos predeterminados, permisos y roles de 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 de símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en 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 identificador URI de la colección de proyectos de equipo. El formato del identificador URI es el siguiente: http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección Por ejemplo: http://ServerName:8080/tfs/Collection0 Si no se utiliza un directorio virtual, el formato del identificador URI es el siguiente: http://NombreServidor:Puerto/NombreColección
/n:LinkName	El nombre o el nombre de referencia del tipo de vínculo que se desea desactivar o eliminar.
/f:FileName	El archivo XML de tipos de vínculo. Se requiere para la importación, es opcional para la exportación. Si omite este parámetro, el resultado del comando aparece en la presentación.
/e:encoding	Nombre de un formato de codificación de .NET Framework 2.0. La codificación especificada se utilizará para exportar o importar los datos XML. Por ejemplo, /e:utf-7 especifica la codificación Unicode (UTF-7). Si omite este parámetro, witadmin intenta detectar la codificación, y si se produce un error en la detección, witadmin utiliza UTF-8.
/v	Valida el tipo de vínculo XML sin importarlo.
/noprompt	Deshabilita el aviso para la 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 Trabajar con tipos de vínculos.

Ejemplos

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

Identificador URI de la colección de proyectos de equipo: http://AdventureWorksServer:8080/AWTeam/Collection1
Nombre del servidor: AdventureWorksServer
Nombre del archivo de entrada o salida: myLinkTypes.xml
Nombre del tipo de vínculo: mylinktype
Codificación predeterminada: UTF-8

Mostrar tipos de vínculo

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

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Mostrar la definición de un tipo de vínculo

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

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Desactivar y, a continuación, reactivar un tipo de vínculo

Los siguientes ejemplos desactivan el tipo de vínculo mylinktype y, a continuación, lo reactivan:

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype

Exportar la definición de un tipo de vínculo

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

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

Importar 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/AWTeam/Collection1 /f:mylinktype.xml

Vea también

Compartir a través de