Compartilhar via


Mapear uma coleção de projeto de equipe para uma instância de PWA

Antes de poder sincronizar dados entre Visual Studio Team Foundation Server e Microsoft Project Server, você deve executar várias tarefas que incluem mapear uma coleção de projeto de equipe a uma instância de acesso Web de Projeto ou projeto o aplicativo (PWA) da Web. Você pode gerenciar esse mapeamento usando as seguintes opções de ferramenta de linha de comando TFSAdmin :

  • /MapPWAToCollection: Mapear uma coleção de projeto de equipe a uma instância de PWA. Você pode mapear várias coleções para uma instância, mas você pode mapear cada coleção a apenas uma instância. Antes de você pode mapear uma coleção para uma instância, você deve registrar a instância.

  • /GetMappedCollections: Retorna a lista de coleções de projeto de equipe que foram mapeadas para uma instância de PWA.

  • /UnmapPWAFromCollection: Remove o mapeamento de uma coleção de projeto de equipe de uma instância de PWA.

Para obter uma visão geral de ponta a ponta de como integrar técnicas esses produtos, consulte Configurar a integração TFS-Project Server.

Para usar a ferramenta de linha de comando TFSAdmin, abra uma janela de Prompt de Comando onde Visual Studio ou Team Explorer está instalado e digite:

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 usar esses comandos, sua permissão de Administrar a integração com o Project Server para a coleção de projeto de equipe deve ser definida como Permitir. Além disso, a conta de serviço para Team Foundation Server deve ser concedido as permissões necessárias para interagir com a instância de PWA que participará na sincronização de dados. Para obter mais informações, consulte Atribuir permissões para dar suporte à integração TFS-Project Server.

Dica

Mesmo se estiver conectado com permissões administrativas, você deve abrir uma janela de Prompt de Comandos com privilégios elevados para executar esta função em um servidor que esteja executando o Windows Server 2008.Para abrir uma janela elevada de prompt de comando, escolha Iniciar, abra o menu de contexto do Prompt de Comando, e então escolha Executar como administrador.Para obter mais informações, consulte a seguinte página no site da Microsoft: Controle de acesso do usuário.

Sintaxe

TfsAdmin ProjectServer /GetMappedCollections /tfs:tfsUrl

TfsAdmin ProjectServer /MapPWAToCollection /pwa:pwaUrl /collection:tpcUrl

TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:pwaUrl /collection:tpcUrl [/force]

Parâmetros

Parâmetro

Descrição

/tfs:tfsUrl

Especifica a URL de um servidor de camada de aplicativo para o Team Foundation. Especifique a URL no seguinte formato:

http://ServerName:Port/VirtualDirectoryName

Se você não especificar um diretório virtual, você especifica a URL no seguinte formato:

http://ServerName:Port

/pwa:pwaUrl

Especifica a URL de uma instância de PWA. Especifique a URL no seguinte formato:

http://PWAServerName/PWA

/collection:tpcUrl

Especifica a URL de uma coleção de projeto de equipe. Especifique a URL no seguinte formato:

http://ServerName:Port/VirtualDirectoryName/CollectionName

Se você não especificar um diretório virtual, você especifica a URL no seguinte formato:

http://ServerName:Port/CollectionName

/force

Opcional. Disponível para a opção de /UnmapPWAFromCollection somente. Remove todos os mapeamentos para todos os projetos de equipe na coleção. Você deve especificar esta opção somente se você tiver certeza de que você não desejar que todos os projetos de equipe na coleção continuar a participar na sincronização de dados.

/? ou help

Exibe informações sobre o comando.

Comentários

Quando você executa um comando, uma mensagem aparece e confirmar a ação que está sendo executada e o objeto de ação. Por exemplo, a seguinte mensagem indica que a instância especificada de PWA está sendo mapeada:

Mapping Project Web Access:http://MyPWAServer/MyPWAInstance/ . . . Done.

Outra mensagem aparece após o comando ser concluído. Por exemplo, a seguinte mensagem indica que a instância de PWA foi registrada com Team Foundation Server:

Mapping team project collection http://MyTFSServer:8080/tfs/Collection0 to PWA http://MyPWAServer/MyPWAInstance/. 

As seguintes operações são executadas quando você mapeia uma coleção de projeto de equipe:

  • O serviço de rede local para a coleção é atualizado com o mapeamento.

  • As regras e os campos globais na coleção são criados.

  • O mecanismo de sincronização é registrado com o serviço de trabalho.

Antes que você possa unmap uma coleção de uma instância de PWA, você deve primeiro unmap todos os projetos de equipe e planos de projeto da empresa que são mapeados para a coleção de projeto de equipe. Se os projetos são mapeados quando você executa a opção de /UnmapPWAFromCollection , uma mensagem que notifica você primeiro você deve usar a opção de /UnmapPlanFromProject . Como alternativa, você pode usar o sinalizador de /force para remover todos os mapeamentos para todos os projetos de equipe na coleção.

Você pode exibir uma lista de projetos mapeados executando a opção de /GetMappedProjects . Para obter mais informações, consulte Gerenciar mapeamentos entre um projeto corporativo e um projeto de equipe.

Se você executar /UnmapPWAFromCollection em uma coleção para que nenhum projeto está mapeado, o comando remove não apenas o mapeamento mas também as regras de estilo globais.

Exemplos

Os valores a seguir se aplicam em cada exemplo:

  • URL para a instância de PWA: http:// PWAServerName/PWAInstance/

  • URL para Team Foundation Server: http://AdventureWorksServer:8080/tfs/

  • URL para a coleção de projeto de equipe: http://AdventureWorksServer:8080/tfs/DefulatCollection

Coleções de Projeto de lista que são mapeadas

O exemplo a seguir lista as coleções de projeto de equipe que são definidas em AdventureWorksServer e que são mapeadas para uma instância de PWA.

TfsAdmin ProjectServer /GetMappedCollections /tfs:http://AdventureWorksServer:8080/tfs/

Mapear uma coleção de Projeto de equipe a uma instância de PWA

O exemplo a seguir mapeia DefaultCollection a PWAInstance, que é definido em AdventureWorksServer.

TfsAdmin ProjectServer /MapPWAToCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Remova o mapeamento de uma coleção

O exemplo a seguir remove o mapeamento de DefaultCollection de PWAInstance.

TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Consulte também

Tarefas

Configurar a integração TFS-Project Server

Conceitos

Remover um componente da participação na sincronização de dados

Mapear componentes de integração [TfsAdmin ProjectServer]