Comando ConfigureConnections

Articolo
09/12/2008

Aggiornamento: novembre 2007

Utilizzare il comando ConfigureConnections per modificare l'interfaccia di connessione per Team Foundation Server.

Nota importante:
Dopo avere utilizzato il comando ConfigureConnections nel server, i computer client che tentano di connettersi saranno ancora configurati con le impostazioni obsolete. È necessario cancellare le cache di questi computer o indicare agli utenti come eseguire la cancellazione delle cache tramite la procedura riportata nella sezione relativa alle osservazioni più avanti in questo argomento.

Autorizzazioni necessarie

Per utilizzare il comando ConfigureConnections, è necessario essere membro del gruppo di sicurezza Administrators di Team Foundation nel server di livello applicazione di Team Foundation e membro del gruppo di sicurezza sysadmin per SQL Server nel server di livello dati di Team Foundation. Se si utilizza l'opzione /proxy, è necessario essere un amministratore sul server di livello applicazione e sul server proxy di Team Foundation. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

Nota:
Anche se l'accesso è stato eseguito con le credenziali amministrative, è necessario aprire un prompt dei comandi con privilegi elevati per eseguire questa funzione in un server con Windows Server 2008 in esecuzione. Per aprire un prompt dei comandi con privilegi elevati, fare clic Start, fare clic con il pulsante destro del mouse su Prompt dei comandi e fare clic su Esegui come amministratore. Per ulteriori informazioni, vedere il sito Web Microsoft (informazioni in lingua inglese).

Anche se l'accesso è stato eseguito con le credenziali amministrative, è necessario aprire un prompt dei comandi con privilegi elevati per eseguire questa funzione in un server con Windows Server 2008 in esecuzione. Per aprire un prompt dei comandi con privilegi elevati, fare clic Start, fare clic con il pulsante destro del mouse su Prompt dei comandi e fare clic su Esegui come amministratore. Per ulteriori informazioni, vedere il sito Web Microsoft (informazioni in lingua inglese).

TFSAdminUtil ConfigureConnections [/View] [/proxy] [/ClientCertificate :(user|computer)] [/ATUri:<uri>] [/PublicATUri:<uri>] [/SharepointUri:<uri>] [/SharepointSitesUri:<uri>] [/SharepointAdminUri:<uri>] [/SharepointUnc:<unc>] [/ReportsUri:<uri>] [/ReportServerUri:<uri>] [/TswaUri:<uri>]

Parametri

Argomento	Descrizione
user	Utilizzare con l'opzione /clientcertificate per specificare di utilizzare l'archivio certificati dell'utente.
computer	Utilizzare con l'opzione /clientcertificate per specificare di utilizzare l'archivio certificati del computer.
URI	Utilizzare per impostare l'URI (Uniform Resource Indicator) con l'opzione adatta.

Opzione	Descrizione
/view	Visualizza le impostazioni di connessione correnti per Team Foundation Server.
/proxy	Esegue il comando per l'account del proxy di Team Foundation Server. Se si utilizza l'opzione /proxy, è possibile utilizzare solo l'opzione /clientcertificate.
/ClientCertificate	Specifica l'archivio certificati dell'utente o del computer al quale si desidera aggiungere un certificato.
/ATUri	Specifica l'URI (Uniform Resource Indicator) di livello applicazione.
/PublicATUri	Specifica l'URI da utilizzare nel testo degli avvisi di posta elettronica.
/SharepointSitesUri	Specifica l'URI del sito SharePoint.
/SharepointAdminUri	Specifica l'URI del sito amministrativo di SharePoint.
/SharepointUnc	Specifica il percorso UNC (Uniform Naming Convention) di SharePoint.
/ReportsUri	Specifica l'RI per SQL Server Reporting Services. È possibile visualizzare report specifici di Team Foundation Server da questo sito.
/ReportServerUri	Specifica l'URI per il servizio Web di ReportService.asmx.
/TswaUri	Specifica gli URI per i vari componenti di Team System Web Access, se installato.

Note

Nota importante:
È consigliabile eseguire il backup dei database nel server di livello dati di Team Foundation Server prima di eseguire il comando ConfigureConnections. È anche utile per eseguire il comando utilizzando l'opzione /view per visualizzare innanzitutto le impostazioni esistenti.

Il comando ConfigureConnections viene utilizzato da un amministratore che desidera modificare le informazioni di configurazione, ad esempio il nome del server o il numero di porta, per uno o più componenti di Team Foundation Server. L'amministratore esegue questo strumento dal livello applicazione per aggiornare tutti i server Team Foundation che includono le informazioni sulla nuova configurazione.

L'utilità aggiorna le informazioni di configurazione come segue:

L'opzione /ATUri imposta le informazioni di configurazione nel file web.config di Servizi Web, nel file CoverAn.exe.config, nel file TFSServerScheduler.exe.config e nel database Team Foundation.
L'opzione /PublicATUri imposta le informazioni di configurazione nel file web.config di Servizi Web.
L'opzione /ClientCertificate apre l'archivio certificati per l'utente o il computer, a seconda dell'argomento. Dopo che l'utente specifica il certificate da utilizzare, le informazioni vengono impostate nel file web.config di Servizi Web, nel file CoverAn.exe.config e nel file TFSServerScheduler.exe.config.
Le opzioni /SharePointUri/SharepointSitesUri, /SharePointUnc e /SharepointAdminUri impostano le informazioni di configurazione per Prodotti e tecnologie SharePoint nel database di Team Foundation.
Le opzioni /Reports e /ReportServer impostano le informazioni di configurazione per SQL Server Reporting Services nel database di Team Foundation.
L'opzione /TswaUri imposta le informazioni di configurazione per Team System Web Access, se installato.

Il comando ConfigureConnections non cancella le cache sui computer client in modo che possano utilizzare le nuove informazioni di configurazione per i componenti di Team Foundation Server. Prima che i computer client possano utilizzare le nuove informazioni, è necessario prima cancellare manualmente le cache.

Per cancellare la cache in un computer client per Team Foundation

Accedere al computer client utilizzando le credenziali dell'utente di cui si desidera aggiornare l'account e chiudere qualsiasi istanza aperta di Visual Studio.
Aprire un browser e passare a una delle cartelle seguenti, a seconda del sistema operativo in esecuzione nel computer client:
- Windows XP o Windows Server 2003
  
  Unità**:\Documents and Settings\NomeUtente\Local Settings\Application Data\Microsoft\Team Foundation\2.0\Cache**
- Windows Vista
  
  Unità**:\Users\NomeUtente\Application Data\Local\Microsoft\Team Foundation\2.0\Cache**
Eliminare il contenuto della directory della cache, includendo tutte le sottocartelle.
Ripetere questi passaggi per ogni account utente nel computer che accede a Team Foundation Server.

Nota:

È possibile distribuire istruzioni sulla cancellazione della cache a tutti gli utenti di Team Foundation Server affinché possano cancellarla personalmente.

Nota:
È possibile distribuire istruzioni sulla cancellazione della cache a tutti gli utenti di Team Foundation Server affinché possano cancellarla personalmente.

Esempio

Nell'esempio seguente vengono visualizzati i valori correnti per ATUri, PublicATUri, SharepointUri, SharepointSitesUri, SharepointAdminUri, SharepointUnc, ReportsUri, ReportServerUri e TswaUri. Se non è impostato alcun valore, l'output indica che non è stato impostato alcun valore.

>TFSAdminUtil ConfigureConnections /view

Nell'esempio seguente, PublicATUri viene impostato sul nuovo valore: http://contoso.example.com:8080.

>TFSAdminUtil ConfigureConnections /PublicATUri:http://contoso.example.com:8080

Vedere anche

Altre risorse

Utilizzo degli strumenti della riga di comando di Team Foundation Server

Amministrazione di Team Foundation Server

Gestione dei servizi e degli account di servizio di Team Foundation Server

Condividi tramite