Personalização e gerenciamento de tipos de Link

Artigo
08/01/2011

Você pode gerenciar os tipos de link definidos para uma coleção de projeto de equipe usando o seguinte witadmin comandos:

deactivatelinktype: Desativa o tipo de vínculo especificado. Os usuários não poderão criar links desse tipo. Links existentes deste tipo continuará a funcionar corretamente.
deletelinktype: Permanentemente remove o tipo de vínculo especificado 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 já existir um tipo de link com o mesmo nome de referência, ela será atualizada para coincidir com o 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.

O witadmin o utilitário de linha de comando está localizado na da unidade:\Arquivos de Programas\Microsoft 10.0\Common7\IDE de Visual Studio no computador cliente que executa o Team Explorer.

Observação
Você pode criar e modificar os tipos de link usando o Process Editor, uma ferramenta de alimentação para Visual Studio. Essa ferramenta não é suportada. Para obter mais informações, consulte a seguinte página no site da Microsoft: Team Foundation Server Power Tools em abril de 2010.

Permissões necessárias

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

Para listar ou exportar tipos de link, você deve ser um membro da leitores do grupo ou ter sua Exibir itens neste aceno de trabalhoe a permissão definida como Permitir
Para excluir, importar ou tipos de link de reativo, você deve ser um membro do Administradores do Team Foundation o grupo de segurança ou o Administradores de projeto o grupo de segurança.

For more information, see Permissões de Team Foundation Server and Team Foundation Server de grupos, permissões e funções.

Observação
Mesmo se fizer logon com permissões administrativas, você deve abrir uma janela de Prompt de comando com privilégios elevados para executar essa função em um servidor que esteja executando o Windows Server 2008. Para abrir uma janela de Prompt de comando com privilégios elevados, clique em Iniciar, com o botão direito o Prompt de comandoe em seguida, clique em Executar como administrador. Para obter mais informações, consulte o site da Microsoft: Controle de acesso do usuário.

Mesmo se fizer logon com permissões administrativas, você deve abrir uma janela de Prompt de comando com privilégios elevados para executar essa função em um servidor que esteja executando o Windows Server 2008. Para abrir uma janela de Prompt de comando com privilégios elevados, clique em Iniciar, com o botão direito o Prompt de comandoe em seguida, clique em 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

Parameter	Description
/collection:CollectionURL	Especifica o URI da coleção de projeto de equipe. O formato para o URI é o seguinte: http: / /Nome_do_servidor: port/VirtualDirectoryName/NomeDaColeta For example: http: //ServerName:8080/tfs/Collection0 Se um diretório virtual não for usado, o formato para o URI é o seguinte: http: / /Nome_do_servidor: port / NomeDaColeta
/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 importação, opcional para exportação. Se você omitir esse parâmetro, a saída do comando aparece na tela.
/e:encoding	O nome de um .NET Framework 2.0 codificação formato. A codificação especificada será usada para exportar ou importar os dados XML. Por exemplo, /e:utf-7 Especifica a 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	Desativa o prompt de confirmação.
/? ouhelp	Exibe ajuda sobre o comando na janela do Prompt de comando.

Comentários

Para a estrutura do esquema de definição de tipo de link, consulte Trabalhando com tipos de Link.

Examples

A menos que especificado em contrário, os valores a seguir aplicam-se em cada exemplo:

URI para a coleção de projeto de equipe: http://AdventureWorksServer:8080/AWTeam/Collection1
Nome do servidor: AdventureWorksServer
Entrada ou saída nome de arquivo: myLinkTypes.xml
Nome do tipo de link: mylinktype
Padrão de codificação: UTF-8

Lista os tipos de Link

O comando a seguir exibe os tipos de links personalizada definidos para Team Foundation AdventureWorksServer.

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

A definição de um tipo de Link de lista.

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

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

Desative e reative o tipo de Link

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

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

Exportar a definição de um tipo de Link

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

Importar a definição dos tipos de Link

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

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

Consulte também

Compartilhar via