Registrar uma instância de PWA para TFS

Artigo
06/10/2015

Antes de sincronizar os dados entre Visual Studio Team Foundation Server 2013 e o servidor Microsoft Project, configure vários pontos de integração entre eles. Primeiro, você deve registrar a instância do acesso Web do Projeto ou do aplicativo Web do Projeto (PWA) que suporta um plano de projeto da empresa com o servidor de camada de aplicativo que hospeda a coleção de projeto de equipe que contém um projeto de equipe. Você pode gerenciar o registro dessas instâncias de PWA usando as seguintes opções da ferramenta de linha de comando TfsAdmin ProjectServer:

/RegisterPWA: Registra uma instância de PWA para Team Foundation Server.

Importante

Para se conectar a Project Server 2010, o aplicativo web do SharePoint para a instância de PWA deve ser definida como Autenticação de Modo Clássico.Você não poderá registrar a instância do PWA se estiver definida como Autenticação Baseada em Declarações.
/GetRegisteredPWA: Lista as instâncias registradas de PWA e os nomes de servidores que estão executando Team Foundation Server para as instâncias registradas.
/UnregisterPWA: Remove a associação registrada entre uma instância de PWA e Team Foundation Server. Quando você move uma coleção de projetos de equipe ou uma implantação de Team Foundation Server, pode remover as instâncias registradas de PWA e, então, registrá-las novamente após a movimentação.

Para obter mais informações sobre a configuração e a integração do servidor de projeto e do Team Foundation Server, 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, você deve pertencer ao grupo Administradores do Team Foundation. Para registrar ou cancelar o registro de uma instância de PWA, você também deve pertencer ao grupo Administradores da instância. 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 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 /GetRegisteredPWA /tfs:tfsUrl

TfsAdmin ProjectServer /RegisterPWA /pwa:pwaUrl /tfs:tfsUrl [/previousPwa:pwaUrl] [/force]

TfsAdmin ProjectServer /UnregisterPWA /pwa:pwaUrl /tfs:tfsUrl

Parâmetros

Parâmetro	Descrição
/tfs:tfsUrl	Especifica a URL de um servidor de camada de aplicativo para o Team Foundation. Especifique a URI no seguinte formato: http://ServerName:Port/VirtualDirectoryName Se você não especificar um diretório virtual, deverá especificar 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/PWAInstance
/previousPwa:pwaUrl	Especifica a URL que foi mais recentemente registrada para uma instância de PWA. Quando o URL muda para um PWA registrado, você pode usar esse switch para registrar novamente o PWA. Especifique a URL no seguinte formato: http://PWAServerName/PWAInstance
/force	Registra uma instância de PWA em outro servidor que está executando o Team Foundation Server, e cancela o registro da instância do servidor no qual foi registrada mais recentemente. Por exemplo, quando você move uma coleção de projeto para outro servidor de camada de aplicativo, você deve registrar novamente o PWA para a coleção com o novo servidor.
/? ou help	Exibe informações sobre o comando.

Comentários

Quando você executa um comando TFSAdmin ProjectServer, uma mensagem aparece e confirma que o comando está sendo executado. Por exemplo, a seguinte mensagem indica que a instância do acesso Web de Projeto está sendo registrada:

Registering PWA http:// PWAServerName/PWAInstance/

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

You have successfully registered PWA http://PWAServerName/PWAInstance/

Você pode registrar uma instância de PWA com apenas um servidor de camada de aplicativos para Team Foundation. Você deve registrar uma instância antes que você possa associá-la a uma coleção de projeto de equipe. Quando você registra uma instância, o serviço de localização de Team Foundation Server é atualizado com essas informações. Além disso, a instância do PWA é atualizada com os campos e as tabelas de pesquisa personalizados que a integração requer.

Quando você executa um comando de registro, as seguintes operações ocorrem:

Se você executar /RegisterPWA mais de uma vez e uma entrada do registro já existir, a seguinte mensagem aparecerá:

The following PWA instance has already been registered: <PWAInstance>.
Quando você executa /GetRegisteredPWA, as seguintes informações são exibidas:
```
The following PWA instances are registered:  
PWA URL 1
PWA URL 2
```
Quando você executa a opção /UnRegisterPWA, o comando remove não apenas a associação mapeada, mas também as tabelas de pesquisa e os campos personalizados da instância de PWA.

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/

Listar as instâncias de PWA registradas

O exemplo a seguir lista as instâncias de PWA que são registradas em AdventureWorksServer:

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