Gerenciar a lista Global de tipos de Item de trabalho

Usando listas globais, você pode minimizar o trabalho que é necessário para atualizar uma lista de compartilham de vários tipos de itens de trabalho. Listas globais são listas que você pode incluir em um ou mais campos e tipos de itens de trabalho de seleção. Você pode definir listas globais para um projeto de equipe, uma coleção de projeto de equipe, um modelo de processo ou fluxo de trabalho global.

Você pode definir uma lista global em seu próprio arquivo de definição de um para um tipo de item de trabalho ou fluxo de trabalho global. Quando você usa a definição de lista de global, você pode gerenciar as listas globais que são definidas para uma coleção usando os seguintes comandos na witadmin ferramenta de linha de comando:

• destroygloballist: Destrói uma lista global.

• exportgloballist: Exporta as listas globais para um arquivo XML ou para a janela do Prompt de comando.

• importgloballist: Importa a lista global de um arquivo XML. Se você tentar importar uma lista global que já existe no servidor, um aviso perguntará se você deseja substituir aquele no servidor. Se você tentar importar uma lista global que ainda não existir, o comando cria uma nova lista global.

• listgloballist: Exibe o nome de cada lista global definido no servidor.

For more information, see Definir listas globais and Personalizando o fluxo de trabalho Global.

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. Para máquinas de 64 bits, a ferramenta está em Drive: \Arquivos de programas (x86) \Microsoft Visual Studio 10.0\Common7\IDE.

Para obter mais informações sobre listas globais, consulte Definir listas globais.

Observação
Você pode criar e modificar listas globais 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 de equipe onde as listas globais são definidas, você deve ter as seguintes permissões definidas:

• Para exportar ou listas globais de lista, 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 destruir ou importar listas globais, você deve ser um membro da 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 clique em Executar como administrador. Para obter mais informações, consulte esta página no site da Microsoft: Controle de acesso do usuário.

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

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 Se nenhum diretório virtual é usado, o formato para o URI é o seguinte: http: / /Nome_do_servidor: port / NomeDaColeta.
/n:GlobalListName	O nome da lista global para destruir.
/f:FileName	O caminho e o nome do arquivo de definição de lista global XML para exportar ou importar. Observação Se o computador cliente executa Windows Vista, talvez você não tenha permissões para determinadas pastas.Se você tentar exportar a lista de global para um local onde você não tem permissões, a tecnologia de virtualização do registro automaticamente redireciona o arquivo exportado e salva-lo no armazenamento virtual.Para obter mais informações, consulte as seguintes páginas no site da Microsoft: Virtualização de registro e problemas comuns de virtualização de arquivo e registro no Windows Vista.Para evitar esse redirecionamento, você pode exportar o arquivo para um local onde você tem permissões.
/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.
/noprompt	Desativa o prompt de confirmação.
/? ou help	Exibe ajuda sobre o comando na janela do Prompt de comando.

Comentários

Importar uma lista global cria uma lista se não existir. Se já existir na lista, o witadmin importgloballist comando irá avisá-lo que a lista atual será sobrescrita. Você pode escrever seu próprio programa de atualização de uma lista global existente, ou você pode atualizar a lista global com os novos dados.

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

• Número da porta do servidor Web site: 8080

Exibir os nomes das listas globais

O exemplo a seguir mostra as listas globais definidas no servidor. O exemplo exporta as listas globais usando a codificação UTF-8 do padrão:

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

Exportar a definição de listas globais

O exemplo a seguir exporta as listas globais:

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml

O exemplo a seguir exporta as mesmas listas globais no mesmo servidor, mas usa a codificação Unicode (UTF-7):

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml /e:utf-7

Importar a definição das listas globais

O exemplo a seguir importa listas globais:

witadmin importgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml 

O exemplo a seguir importa as mesmas listas globais no mesmo servidor, mas usa a codificação Unicode (UTF-7):

witadmin importgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml /e utf-7

Consulte também

Tarefas

Adicionar, uso e gerenciar listas globais

Conceitos

Definir listas globais

Outros recursos

Personalizando o fluxo de trabalho Global

witAdmin: Administrando objetos para controlar os itens de trabalho

Histórico de alterações

Date	History	Motivo
Janeiro de 2011	Descreveu os benefícios do uso de listas globais e informações sobre o fluxo de trabalho global adicionadas.	Aprimoramento de informações.