Administrar tipos de vínculos
Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Importante
Con witadmin, puede modificar los archivos de definición XML para admitir el modelo de proceso XML local. Para obtener información general sobre los modelos de proceso y lo que se admite, consulte Personalización de la experiencia de seguimiento de trabajo.
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 agregar un nuevo tipo de vínculo a la colección de proyectos, revise los tipos de vínculo disponibles para su uso. Consulte Administración de dependencias, vinculación de elementos de trabajo.
Los tipos de vínculo definidos para una colección de proyectos se administran 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 seguirán funcionando correctamente.
- deletelinktype:quita permanentemente el tipo de vínculo especificado de la base de datos. Todos los vínculos definidos con este tipo de enlace también se quitarán.
- exportlinktype:exporta las definiciones de los 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 desde 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 disponible de tipos de vínculo en un servidor.
- reactivatelinktype:reactiva el tipo de vínculo especificado y, opcionalmente, le asigna un nuevo nombre.
Ejecución de la herramienta de línea de comandos witadmin
Para ejecutar la herramienta de línea de comandos witadmin, abra una ventana del símbolo del sistema Visual Studio está instalado. La herramienta de línea de comandos witadmin se instala con cualquier versión de Visual Studio. Puede acceder a esta herramienta instalando la versión gratuita de Visual Studio Community o Visual Studio Team Explorer.
Nota
Si se conecta a un servidor local, debe usar la misma versión o posterior de Visual Studio o Team Explorer que Azure DevOps Server o TFS. Por ejemplo, si se conecta a una instancia de TFS 2017, debe conectarse desde Visual Studio 2017 o Team Explorer 2017. No hay ninguna versión Team Explorer 2015.
Visual Studio cliente de 2019 Team Explorer 2019:
%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
o , TeamExplorer o en lugar de , en función de la versión que haya ProfessionalEnterpriseCommunity instalado.
Visual Studio cliente de 2017 Team Explorer 2017:
%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
o , TeamExplorer o en lugar de , en función de la versión que haya ProfessionalEnterpriseCommunity instalado.
Visual Studio cliente de 2015:
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
Visual Studio 2013 cliente:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
Team Explorer cliente de 2013:
cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
En una edición de 32 bits de Windows, reemplace %programfiles(x86)% por %programfiles%. Puede instalar Visual Studio Community (que proporciona acceso a Team Explorer) o Visual Studio Team Explorer 2017 de forma gratuita.
Requisitos previos
Para la colección de proyectos donde se definen los tipos de vínculo, debe tener los permisos siguientes establecidos:
- Para enumerar o exportar tipos de vínculos, debe tener el permiso Ver información de nivel de proyecto para un proyecto 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 recopilación de Project o tener el permiso Administrar tipos de vínculo de elemento de trabajo establecido en Permitir.
Para obtener más información, vea Agregar un administrador.
Nota
Incluso si inicia sesión con permisos administrativos, debe abrir una ventana del símbolo del sistema con privilegios elevados para realizar esta función en un servidor que ejecute Windows Server 2008. Para abrir una ventana del símbolo del sistema con privilegios elevados, elija Iniciar,abra el menú contextual del símbolo del sistema y, a continuación, elija Ejecutar como administrador. Para obtener más información, vea el sitio web de Microsoft: User Access Control.
Sintaxis
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: | Especifica el URI de la colección de proyectos. Por ejemplo: http://ServerName:Port/VirtualDirectoryName/CollectionName Si no se usa ningún directorio virtual, el formato del URI es el siguiente: http://ServerName:Port/CollectionName. |
| /n: | El nombre o el nombre de referencia del tipo de vínculo que hay que desactivar o eliminar. |
| /f: | 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: | El nombre de un .NET Framework formato de codificación 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 omite este parámetro, witadmin intenta detectar la codificación y, si se produce un error en la detección, witadmin usa UTF-8. |
| /v | Valida el tipo de vínculo XML sin importarlo. |
| /noprompt | Inhabilita la solicitud de confirmación. |
| /? o ayuda | Muestra ayuda sobre el comando en la ventana del símbolo del sistema. |
Comentarios
Para obtener la estructura del esquema de definición de tipo de vínculo o información sobre cómo puede restringir los tipos de relaciones de vínculo que los miembros del equipo pueden realizar, vea LinksControlOptions.
Ejemplos
A menos que se especifique lo contrario, se aplican los siguientes valores en cada ejemplo:
- URI de la colección de proyectos: 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 Team Foundation AdventureWorksServer.
witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
Enumerar la definición de un 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
Desactivación y reactivación de 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
Exportación de la definición de un 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
Importación de 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