Eseguire il mapping di una raccolta di progetti team a un'istanza di PWA

Articolo
06/10/2015

Prima di poter sincronizzare dati tra Visual Studio Team Foundation Server e Microsoft Project Server, è necessario eseguire diverse attività, tra cui il mapping di una raccolta di progetti team a un'istanza di Project Web Access o Project Web App (PWA). È possibile gestire questo mapping tramite le opzioni seguenti dello strumento da riga di comando TFSAdmin:

/MapPWAToCollection: consente di eseguire il mapping di una raccolta di progetti team a un'istanza di PWA. È possibile eseguire il mapping di più raccolte a un'istanza, ma di ciascuna raccolta a una sola istanza. Prima di poter eseguire il mapping di una raccolta a un'istanza, è necessario registrare l'istanza.
/GetMappedCollections: consente di visualizzare l'elenco di raccolte di progetti team mappato a un'istanza di PWA.
/UnmapPWAFromCollection: consente di rimuovere il mapping di una raccolta di progetti team da un'istanza di PWA.

Per una panoramica globale della modalità di integrazione di questi prodotti, 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 e digitare:

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 che l'autorizzazione Amministrazione integrazione di Project Server per la raccolta di progetti team sia impostata su Consenti. Inoltre, all'account del servizio di Team Foundation Server devono essere concesse le autorizzazioni necessarie per interagire con l'istanza di PWA che prenderà parte alla sincronizzazione dei dati. 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 elevati, 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 /GetMappedCollections /tfs:tfsUrl

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

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

Parametri

Parametro	Descrizione
/tfs:tfsUrl	Consente di specificare l'URL (Uniform Resource Locator) di un server a livello applicazione per Team Foundation. Specificare l'URL nel seguente formato: http://ServerName:Port/VirtualDirectoryName Se non si specifica una directory virtuale, specificare l'URI nel seguente formato: http://ServerName:Port
/pwa:pwaUrl	Specifica l'URL di un'istanza di PWA. Specificare l'URL nel seguente formato: http://PWAServerName/PWA
/collection:tpcUrl	Specifica l'URL di una raccolta di progetti team. Specificare l'URL nel seguente formato: http://ServerName:Port/VirtualDirectoryName/CollectionName Se non si specifica una directory virtuale, specificare l'URI nel seguente formato: http://ServerName:Port/CollectionName
/force	Parametro facoltativo. Disponibile solo per l'opzione /UnmapPWAFromCollection. Consente di rimuovere tutti i mapping per tutti i progetti team nella raccolta. È necessario specificare questa opzione solo se non si desidera più che i progetti team nella raccolta continuino a partecipare alla sincronizzazione dei dati.
/? o help	Consente di visualizzare le informazioni sul comando.

Note

Quando si esegue un comando, viene visualizzato un messaggio dove vengono confermati l'azione da eseguire e l'oggetto dell'azione. Ad esempio, il messaggio seguente indica che è in corso il mapping del piano dell'istanza di PWA specificata:

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

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

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

Le operazioni seguenti vengono effettuate quando si esegue il mapping di una raccolta di progetti team:

Il servizio di percorso per la raccolta viene aggiornato con il mapping.
Nella raccolta vengono creati regole e campi globali.
Il motore di sincronizzazione è registrato con il servizio del processo.

Prima di potere annullare il mapping di una raccolta da un'istanza di PWA, è necessario annullare il mapping di tutti i progetti team e i piani del progetto dell'organizzazione mappati per la raccolta di progetti team. Se i progetti vengono mappati quando si esegue l'opzione /UnmapPWAFromCollection, un messaggio di notifica informa l'utente che è necessario utilizzare prima l'opzione /UnmapPlanFromProject. In alternativa, è possibile utilizzare il flag /force per rimuovere tutti i mapping per tutti i progetti team nella raccolta.

È possibile visualizzare un elenco di progetti mappati eseguendo l'opzione /GetMappedProjects. Per ulteriori informazioni, vedere Gestire i mapping tra un progetto dell'organizzazione e un progetto team.

Se si esegue /UnmapPWAFromCollection in una raccolta a cui non viene eseguito il mapping di nessun progetto, il comando consente di rimuovere non solo il mapping ma anche le regole globali.

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/
URL per la raccolta di progetti team: http://AdventureWorksServer:8080/tfs/DefaultCollection

Elencare le raccolte di progetti mappate

Nell'esempio seguente vengono elencati le raccolte di progetti team definite in AdventureWorksServer e mappate a un'istanza di PWA.

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