Compartilhar via

Gerenciar tipos de link [witadmin]

  • Artigo

Assim como os tipos de item de trabalho, você pode definir e modificar tipos de link personalizado. No entanto, você não pode fazer alterações de tipos de link definidos pelo sistema. Antes de adicionar um novo tipo de link para sua coleção de projetos de equipe, examine os tipos de link disponíveis para uso. Consulte Vincular itens de trabalho para oferecer suporte à rastreabilidade.

Gerenciar os tipos de link definidos para uma coleção de projetos de equipe usando o seguinte witadmin comandos:

  • deactivatelinktype: Desativa o tipo de link especificado. Os usuários não poderão criar links desse tipo. Links existentes desse tipo continuarão a funcionar corretamente.

  • deletelinktype: Remove o tipo de link especificado permanentemente do banco de dados. Todos os links definidos com esse tipo de link também são removidos.

  • exportlinktype: Exporta as definições dos tipos de link. Você pode exportar a definição de um tipo de link único ou todos os tipos de link definidos para o servidor.

  • importlinktype: Importa as definições dos tipos de link de um arquivo XML. Se um tipo de link com o mesmo nome de referência já existir, ele será atualizado para corresponder ao tipo de link importados. Se o tipo de link ainda não existir, será criado um novo tipo de link.

  • listlinktypes: Lista o conjunto disponível de tipos de link em um servidor.

  • reactivatelinktype: Reativa o tipo de vínculo especificado e, opcionalmente, atribui um novo nome.

Para executar a ferramenta da linha de comandos witadmin, abra uma janela do Prompt de Comando em que Visual Studio ou Team Explorer esteja instalado e insira:

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

Em uma edição de 32 bits do Windows, substitua %programfiles(x86)% por %programfiles%.

Requisitos

Para a coleção de projetos de equipe onde são definidos os tipos de link, você deve ter as seguintes permissões definido:

  • Para listar ou exportar tipos de link, você deve ter seu exibir informações em nível de projeto permissão para um projeto de equipe na coleção definida como permitir.

  • To delete, import, or reactive link types, you must be a member of the Project Collection Administrators security group or have your Manage work item link types permission set to Allow.

Para obter mais informações, consulte Referência de permissões para o Team Foundation Server.

Dica

Mesmo que faça logon com permissões administrativas, você deve abrir uma janela elevada do Prompt de Comando para executar essa função em um servidor que esteja executando Windows Server 2008.Para abrir uma janela do Prompt de Comando elevado, escolha Iniciar, abra o menu de atalho do Prompt de Comando e, em seguida, escolha Executar como Administrador.Para obter mais informações, consulte o site da Microsoft: Controle de Acesso do Usuário.

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

Descrição

/collection:CollectionURL

Especifica o URI da coleção de projeto de equipe. O formato do URI é o seguinte: http://ServerName:Port/VirtualDirectoryName/CollectionName

Por exemplo:

http: //ServerName:8080/tfs/Collection0

Se um diretório virtual não for usado, o formato do URI é o seguinte:

http://ServerName:Port/CollectionName

/n:LinkName

O nome ou o nome de referência do tipo de link para desativar ou excluir.

/f:FileName

O arquivo XML de tipos de link. Necessário para a importação, opcional para exportação. Se você omitir esse parâmetro, a saída do comando é exibido na tela.

/e:encoding

O nome de um formato de codificação .NET Framework 2,0. A codificação especificada será usada para exportar ou importar os dados XML. Por exemplo, /e:utf-7 especifica codificação Unicode (UTF-7). Se você omitir esse parâmetro, witadmin tenta detectar a codificação, e se a detecção de falha, witadmin usa UTF-8.

/v

Valida o tipo de link XML sem importá-los.

/noprompt

Desabilita o prompt para confirmação.

/? ou help

Exibe ajuda sobre o comando na janela Prompt de comando.

Comentários

Para a estrutura do esquema de definição de tipo de link, consulte Referência de elementos de tipo de link.

Para obter informações sobre como você pode restringir os tipos de relações de link que os membros da equipe podem fazer, consulte Vincular controles, restrições e referência de campo e Elementos LinksControlOptions.

Exemplos

A menos que especificado de outra forma, os seguintes valores se aplicam a cada exemplo:

  • URI da coleção do projeto de equipe: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Nome do servidor: AdventureWorksServer

  • Entrada ou saída nome do arquivo: myLinkTypes.xml

  • Nome do tipo de link: mylinktype

  • Codificação padrão: UTF-8

O comando a seguir exibe os tipos de link personalizado definidos para Team Foundation AdventureWorksServer.

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

O exemplo a seguir exibe a definição do tipo de link na janela do Prompt de comando:

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

Os exemplos a seguir desativar o tipo de link, mylinktype e, em seguida, reativá-la:

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

O comando a seguir exporta a definição de todos os tipos de link para o arquivo mylinktype.xml:

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

O exemplo a seguir importa a definição dos tipos de link definidos no arquivo XML:

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

Consulte também

Conceitos

Referência de elementos de tipo de link

Vincular controles, restrições e referência de campo

Outros recursos

Vincular itens de trabalho para oferecer suporte à rastreabilidade

witAdmin: personalizar e gerenciar objetos para acompanhar trabalho