Comando ChangeServerID
Il comando ChangeServerID modifica gli identificatori univoci globali (GUID, Global Universal Identification) associati ai database di Visual Studio Team Foundation Server (TFS).I GUID devono essere univoci all'interno di una distribuzione di TFS.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 della raccolta 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 della raccolta 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 la classe 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.
TFSConfig ChangeServerID /SQLInstance:ServerName] /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly] [/usesqlalwayson]
Parametri
Placeholder |
Descrizione |
---|---|
ServerName |
Specifica il nome del server che ospita il database di configurazione di TFS 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 |
Descrizione |
---|---|
/SQLInstance:ServerName |
Necessario.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 |
Necessario.Specifica il nome del database di configurazione di TFS. |
/ProjectCollectionsOnly |
Specifica che solo i GUID delle raccolte verranno modificati. |
/ConfigDBOnly |
Specifica che solo il GUID del database di configurazione verrà modificato. |
/usesqlalwayson |
Specifica che i database fanno parte di un gruppo di disponibilità AlwaysOn in SQL Server.Questa opzione, se precedentemente configurata, imposta MultiSubnetFailover nella stringa di connessione. Per ulteriori informazioni, vedere Gruppi di disponibilità AlwaysOn (SQL Server). |
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 TFS , dove il database di configurazione è ospitato nel server denominato "ContosoMain" nell'istanza denominata "TeamDatabases" in SQL Server.
[!NOTA]
Gli esempi utilizzati sono casuali e hanno solo scopo illustrativo.Nessuna associazione reale è intenzionale o può essere presupposta.
TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB
Vedere anche
Attività
Move a Team Project Collection
Split a Team Project Collection
Concetti
Backup e ripristino della distribuzione