Comando RenameDT

Articolo
09/12/2008

Aggiornamento: novembre 2007

Utilizzare RenameDT per modificare il nome del server di livello dati di Team Foundation Server.

Nota importante:
Affinché il comando RenameDT abbia esito positivo è necessario che i pool di applicazioni e i programmi seguenti siano in esecuzione.

Pool di applicazioni di Team Foundation Server (pool di applicazioni)
ReportServer (pool di applicazioni)

Nota:

Il pool di applicazioni ReportServer viene gestito in Internet Information Services (IIS) per SQL Server 2005 ma non per SQL Server 2008.
SQL Server Reporting Services (programma)

Nota:
Il pool di applicazioni ReportServer viene gestito in Internet Information Services (IIS) per SQL Server 2005 ma non per SQL Server 2008.

Autorizzazioni necessarie

Per utilizzare il comando RenameDT è necessario essere membri del gruppo Administrators di Team Foundation nel server di livello applicazione di Team Foundation nonché membri del gruppo sysadmin in SQL Server nel server di livello dati di Team Foundation. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

Nota:
Anche se si è connessi con credenziali amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione in un server che esegue Windows Server 2008. Per aprire una finestra del prompt dei comandi con privilegi elevati, fare clic su Start, fare clic con il pulsante destro del mouse su Prompt dei comandi e quindi fare clic su Esegui come amministratore. Per ulteriori informazioni, vedere il sito Web Microsoft (informazioni in lingua inglese).

Anche se si è connessi con credenziali amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione in un server che esegue Windows Server 2008. Per aprire una finestra del prompt dei comandi con privilegi elevati, fare clic su Start, fare clic con il pulsante destro del mouse su Prompt dei comandi e quindi fare clic su Esegui come amministratore. Per ulteriori informazioni, vedere il sito Web Microsoft (informazioni in lingua inglese).

TFSAdminUtil RenameDT servername

Parametri

Argomento	Descrizione
servername	Specifica il nome del computer di livello dati di destinazione. mediante i seguenti attributi: Indirizzo IP L'indirizzo IP deve essere nel formato: aaa.bbb.ccc.ddd. Nome computer Non è possibile utilizzare spazi o caratteri speciali, ad esempio ";:<>*. Sono consentiti solo i caratteri [A-Z \| 0-9 \| -]. Il nome non può essere composto solo da numeri e può contenere al massimo 15 caratteri ASCII o 7 caratteri per codifiche di caratteri a due byte. Per ulteriori informazioni, vedere Restrizioni di denominazione per Team Foundation Server. Indirizzo dominio Ad esempio, Server.percorso.società.com.

servername

Specifica il nome del computer di livello dati di destinazione. mediante i seguenti attributi:

Indirizzo IP

L'indirizzo IP deve essere nel formato: aaa.bbb.ccc.ddd.
Nome computer

Non è possibile utilizzare spazi o caratteri speciali, ad esempio ";:<>*. Sono consentiti solo i caratteri [A-Z | 0-9 | -]. Il nome non può essere composto solo da numeri e può contenere al massimo 15 caratteri ASCII o 7 caratteri per codifiche di caratteri a due byte. Per ulteriori informazioni, vedere Restrizioni di denominazione per Team Foundation Server.
Indirizzo dominio

Ad esempio, Server.percorso.società.com.

Note

Nota importante:
È consigliabile eseguire il backup dei database nel server di livello dati di Team Foundation Server.

Le stringhe TFSNameUrl e TFS Name nel file Web.config dei servizi, situato nel livello dati nel percorso Unità:\Programmi\Microsoft Visual Studio 2008 Team Foundation Server\Web Services devono fare riferimento al server di livello dati di Team Foundation Server corrente. Altrimenti, il comando RenameDT avrà esito negativo senza avvisare.

Il livello applicazione di Team Foundation Server deve conoscere il nome o l'indirizzo esatto del server di livello dati per poterlo raggiungere. Il nome e l'indirizzo del livello dati vengono memorizzati in diversi percorsi in Team Foundation Server, nei database sia di livello dati che di livello applicazione. Quando è necessario passare a un nuovo livello dati, l'amministratore deve verificare che Team Foundation Server faccia riferimento al nome o all'indirizzo del nuovo livello dati.

Il comando RenameDT dell'utilità della riga di comando TFSAdminUtil automatizza il processo di ridenominazione del livello dati aggiornando Team Foundation Server in modo che faccia riferimento a un nuovo nome o indirizzo. È inoltre possibile eseguire il comando RenameDT da script per automatizzare o pianificare il processo di ridenominazione del livello dati.

Il comando RenameDT può essere eseguito solo a livello applicazione perché il file web.config viene cercato sul computer su cui tale comando è eseguito e non sono disponibili funzionalità di accesso remoto o la possibilità di specificare il computer a livello applicazione di destinazione.

Scenari di utilizzo di esempio

Il comando RenameDT può essere utilizzato dall'amministratore in vari scenari, tra cui quelli elencati di seguito:

L'amministratore deve mettere il livello dati non in linea per eseguire la manutenzione ordinaria e sostituirlo quindi con un altro livello dati temporaneo per evitare tempo di inattività.
L'amministratore esegue il comando RenameDT dell'utilità della riga di comando TFSAdminUtil in modo che Team Foundation Server si connetta al nuovo livello dati temporaneo. Al termine della manutenzione l'amministratore esegue di nuovo l'utilità per ripristinare il livello dati precedente.
Il livello dati non funziona correttamente.
L'amministratore esegue il comando RenameDT affinché Team Foundation Server faccia riferimento a un nuovo server di backup.
Il livello dati viene aggiornato con un nuovo server.
L'amministratore esegue il comando RenameDT affinché Team Foundation Server faccia riferimento al nuovo server di livello dati.
Sono stati definiti nuovi criteri operativi per gli standard di denominazione dei computer appartenenti al livello dati.
L'amministratore utilizza il comando RenameDT per assegnare un nuovo nome più appropriato al livello dati.
L'organizzazione o l'azienda si è espansa e deve eseguire la migrazione da una soluzione a server singolo a una a server doppio.
Dopo avere impostato il nuovo livello dati indipendente, l'amministratore esegue il comando RenameDT affinché Team Foundation Server faccia riferimento al nuovo server.