Registrare un'istanza di PWA in TFS

Articolo
06/10/2015

Prima di poter sincronizzare dati tra Visual Studio Team Foundation Server 2013 e Microsoft Project Server, è necessario configurare diversi punti di integrazione tra i due. Prima, è necessario registrare l'istanza di Project Web Access o Project Web App (PWA) che supporta un piano del progetto dell'organizzazione con il server a livello applicazione che ospita la raccolta di progetti team contenente un progetto team. È possibile gestire la registrazione di tali istanze di PWA tramite le opzioni seguenti dello strumento da riga di comando TfsAdmin ProjectServer:

/RegisterPWA: consente di registrare un'istanza di PWA in Team Foundation Server.

Importante

Quando ci si connette a Project Server 2010, l'applicazione Web SharePoint per l'istanza di PWA deve essere impostata su Autenticazione in modalità classica.Non sarà possibile registrare l'istanza di PWA se viene impostata su Autenticazione basata su attestazioni.
/GetRegisteredPWA: consente di visualizzare l'elenco delle istanze di PWA registrate e i nomi dei server che eseguono Team Foundation Server in cui vengono registrate le istanze.
/UnregisterPWA: consente di rimuovere l'associazione registrata tra un'istanza di PWA e Team Foundation Server. Quando si sposta una raccolta di progetti team o una distribuzione di Team Foundation Server, è possibile rimuovere le istanze registrate di PWA, quindi registrarle nuovamente dopo lo spostamento.

Per ulteriori informazioni sulla configurazione e integrazione di Project Server e Team Foundation Server, vedere Configurare l'integrazione TFS-Project Server.

Per utilizzare lo strumento da riga di comando TfsAdmin, aprire una finestra del prompt dei comandi in cui è installato Visual Studio o Team Explorer ed immettere:

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

In una versione a 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%..

Requisiti

Per utilizzare questi comandi, è necessario appartenere al gruppo Team Foundation Administrators . Per registrare o annullare la registrazione di un'istanza di PWA, è necessario appartenere anche al gruppo Amministratori per l'istanza. Per ulteriori informazioni, vedere Assegnare le autorizzazioni per supportare l'integrazione TFS-Project Server.

Nota

Anche se si accede con autorizzazioni amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione su un server che esegue Windows Server 2008.Per aprire una finestra del prompt dei comandi con privilegi di amministrazione, scegliere Start, aprire il menu di scelta rapida per il prompt dei comandi, quindi scegliere Esegui come amministratore.Per ulteriori informazioni, vedere la seguente pagina nel sito Web Microsoft: Controllo di accesso utente.

Sintassi

TfsAdmin ProjectServer /GetRegisteredPWA /tfs:tfsUrl

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

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

Parametri

Parametro	Descrizione
/tfs:tfsUrl	Consente di specificare l'URL (Uniform Resource Locator) di un server a livello applicazione per Team Foundation. Specificare l'URI nel seguente formato: http://ServerName:Port/VirtualDirectoryName Se non si specifica una directory virtuale, immettere l'URL nel formato seguente: http://ServerName:Port
/pwa:pwaUrl	Specifica l'URL di un'istanza di PWA. Specificare l'URL nel seguente formato: http://PWAServerName/PWAInstance
/previousPwa:pwaUrl	Specifica l'ultimo URL registrato per un'istanza di PWA. Quando viene cambiato un URL in un PWA registrato, è possibile sfruttare questo cambiamento per registrare nuovamente il PWA. Specificare l'URL nel seguente formato: http://PWAServerName/PWAInstance
/force	Registra un'istanza di PWA con un server diverso su cui è in esecuzione Team Foundation Server e annulla la registrazione dell'istanza dal server a cui è stato registrato più recentemente. Ad esempio, quando si sposta una raccolta di progetti su un altro server a livello applicazione, è necessario registrare nuovamente il PWA per la raccolta con il nuovo server.
/? o help	Consente di visualizzare le informazioni sul comando.

Note

Quando si esegue un comando TFSAdmin ProjectServer, viene visualizzato un messaggio dove viene confermata l'esecuzione del comando. Ad esempio, il messaggio seguente indica che è in corso la registrazione dell'istanza di Project Web Access:

Registering PWA http:// PWAServerName/PWAInstance/

Al termine del comando viene visualizzato un altro messaggio. Ad esempio, il messaggio seguente indica che l'istanza di Project Web Access è stata registrata con Team Foundation Server:

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

È possibile registrare un'istanza di PWA con un solo server a livello applicazione per Team Foundation. È necessario registrare un'istanza prima che sia possibile associarla a una raccolta di progetti team. Quando si registra un'istanza, il servizio di percorso per Team Foundation Server viene aggiornato con tali informazioni. Inoltre, l'istanza di PWA viene aggiornata con i campi e le tabelle di ricerca personalizzati che l'integrazione richiede.

Quando viene eseguito un comando di registrazione, si verificano le seguenti operazioni:

Se si esegue /RegisterPWA più di una volta e un record della registrazione già esiste, viene visualizzato il messaggio seguente:

The following PWA instance has already been registered: <PWAInstance>.
Quando si esegue /GetRegisteredPWA, vengono visualizzate le informazioni seguenti:
```
The following PWA instances are registered:  
PWA URL 1
PWA URL 2
```
Quando si esegue l'opzione /UnRegisterPWA, il comando non solo rimuove l'associazione mappata ma anche i campi e le tabelle di ricerca personalizzati dall'istanza di PWA.

Esempi

I valori seguenti vengono applicati a ogni esempio:

URL per l'istanza di PWA: http://PWAServerName/PWAInstance/
URL per Team Foundation Server: http://AdventureWorksServer:8080/tfs/

Elencare le istanze registrate di PWA

Nell'esempio seguente vengono elencate le istanze di PWA registrate in AdventureWorksServer:

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