Comando ChangeServerID
È possibile utilizzare il comando ChangeServerID per modificare gli identificatori univoci globali (GUID, Global Universal IDentification) associati ai database di Visual Studio Team Foundation Server. I GUID devono essere univoci all'interno di una distribuzione di Team Foundation Server. Se più di un database dispone dello stesso GUID, la distribuzione può diventare instabile o inutilizzabile. È possibile modificare il GUID del database di configurazione, i GUID di tutti i database dell'insieme di progetti team nella distribuzione o entrambi. Anche se in genere questo comando non viene utilizzato nelle operazioni più comuni, è possibile utilizzarlo nelle circostanze seguenti:
È stata ripristinata la distribuzione al nuovo hardware. La distribuzione precedente è ancora operativa e si desidera utilizzare entrambe le distribuzioni. Questo scenario talvolta viene definito come clonazione del server.
Si desidera verificare un aggiornamento del software o una configurazione dell'hardware in una distribuzione duplicata, in modo da evitare qualsiasi rischio di interferenza negativa sull'ambiente di produzione.
Si desidera verificare in modo completo il ripristino dei database al nuovo hardware in un'esercitazione o in un ambiente a parte, per garantire che la distribuzione sia ripristinabile.
È necessario reimpostare il GUID di un database dell'insieme dopo averlo spostato in un'altra distribuzione in cui tale GUID è già riservato.
Nota
Il comando ChangeServerID è irreversibile. Dopo aver modificato un GUID, tale modifica può essere annullata esclusivamente mediante il ripristino di una versione precedente di quel database.
Autorizzazioni necessarie
Per utilizzare il comando ChangeServerID, è necessario essere membro del gruppo di sicurezza Administrators di Team Foundation e del gruppo di sicurezza sysadmin per qualsiasi database SQL Server che Team Foundation Server utilizza. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
Nota
Anche se si accede 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 Start, fare clic con il pulsante destro del mouse su Prompt dei comandi, quindi scegliere Esegui come amministratore. Per ulteriori informazioni, vedere questa pagina nel sito Web Microsoft: Controllo dell'account utente.
TFSConfig ChangeServerID /SQLInstance:ServerName] /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly]
Parametri
Placeholder |
Oggetto di descrizione |
|---|---|
ServerName |
Specifica il nome del server che ospita il database di configurazione di Team Foundation Server e, se si desidera utilizzare un'istanza diversa da quella predefinita, il nome dell'istanza. Se si specifica un'istanza, è necessario utilizzare il seguente formato: ServerName\InstanceName |
DatabaseName |
Specifica il nome del database di configurazione. Per impostazione predefinita, il nome di questo database è TFS_ConfigurationDB. |
Opzione |
Oggetto di descrizione |
|---|---|
/SQLInstance:ServerName |
Obbligatoria. Specifica il nome del server in cui SQL Server è in esecuzione e il nome dell'istanza, nel caso in cui si desideri utilizzare un'istanza diversa da quella predefinita. Se si specifica un'istanza, è necessario utilizzare il seguente formato: ServerName\InstanceName |
/DatabaseName:DatabaseName |
Obbligatoria. Specifica il nome del database di configurazione di Team Foundation Server. |
/ProjectCollectionsOnly |
Specifica che solo i GUID degli insiemi verranno modificati. |
/ConfigDBOnly |
Specifica che solo il GUID del database di configurazione verrà modificato. |
Note
Si utilizza il comando ChangeServerID per creare un duplicato discreto di una distribuzione di Team Foundation Server per scopi di test o duplicazione. Dopo aver utilizzato il comando ChangeServerID è necessario indicare ai client di creare una connessione al server modificato prima che possa essere utilizzato.
Esempio
Nell'esempio seguente viene mostrato come modificare i GUID di tutti i database nella distribuzione Contoso1 di Team Foundation Server, dove il database di configurazione è ospitato nel server denominato "ContosoMain" nell'istanza denominata "TeamDatabases" in SQL Server.
Nota
Ogni riferimento a società, organizzazioni, prodotti, nomi di domini, indirizzi di posta elettronica, logo, persone, luoghi ed eventi citati nel presente documento è puramente casuale e ha il solo scopo di illustrare l'uso del prodotto Microsoft.
TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB
Vedere anche
Attività
Spostare un insieme di progetti team
Dividere un insieme di progetti team
Concetti
Backup e ripristino della distribuzione