Comando Branch

Aggiornamento: novembre 2007

Il comando branch consente di copiare un elemento o un insieme di elementi, comprendenti metadati e cronologia del controllo della versione, da una posizione all'altra nel server del Controllo della versione di Team Foundation e nell'area di lavoro locale.

Nota:
I risultati di questo comando non risulteranno disponibili nel server Controllo della versione di Team Foundation finché non verrà eseguita un'operazione di archiviazione. Per ulteriori informazioni, vedere Procedura: archiviare le modifiche in sospeso.

Autorizzazioni necessarie

Per utilizzare il comando branch è necessario disporre dell'autorizzazione Lettura per l'elemento di origine e dell'autorizzazione Estrai per la cartella di destinazione impostate su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

tf branch olditem newitem [/version:versionspec] [/noget] [/lock:none|checkin|checkout] [/checkin] [/noprompt]

Parametri

Argomento	Descrizione
olditem	Specifica il nome del file o della cartella di origine per la quale viene creata la diramazione. Il parametro olditem può inoltre contenere informazioni sulla versione in formato item;version.
Newitem	Specifica il nome del file o della cartella di destinazione oppure della cartella principale per la destinazione. Se newitem esiste già e corrisponde a una cartella del server Controllo della versione di Team Foundation, in Team Foundation gli elementi con diramazione verranno creati all'interno di tale cartella. In caso contrario, il parametro newitem indica il nome del file o della cartella di destinazione. Se la destinazione è già esistente, possono verificarsi conflitti durante l'archiviazione.
Versionspec	Fornisce un valore per l'opzione /version. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sulla specifica di una versione per determinare gli elementi all'interno dell'ambito, vedere Sintassi della riga di comando (Team System).

Opzione	Descrizione
/version	Versione dell'elemento in corrispondenza della quale creare la diramazione. È possibile specificare una versione in base a: Data/ora (D10/20/2005) Numero dell'insieme di modifiche (C1256) Etichetta (Lmylabel) Versione più recente (T) Area di lavoro (Wworkspacename) Se non viene fornita alcuna versione, in Team Foundation viene utilizzata la seguente logica per decidere la versione dell'elemento da copiare nella nuova diramazione: Se viene specificato un percorso server Controllo della versione di Team Foundation, in Team Foundation la diramazione per l'elemento viene creata in corrispondenza dell'ultima versione del server Controllo della versione di Team Foundation. In tf branch $/projects/help.cs viene ad esempio utilizzata la versione del server. Se per l'origine viene specificato un percorso locale, in Team Foundation viene utilizzata la versione locale dell'area di lavoro per creare la nuova diramazione. In tf branch C:\314.cs viene ad esempio utilizzata la versione locale dell'area di lavoro. Se si crea la diramazione per un file la cui versione dell'area di lavoro è meno recente dell'ultima versione disponibile nel server Controllo della versione di Team Foundation, la diramazione viene creata in corrispondenza della versione meno recente.
/lock	Impedisce ad altri utenti di archiviare o estrarre elementi fino a quando non viene eseguita l'archiviazione della diramazione in sospeso e delle modifiche associate. Per ulteriori informazioni, vedere Informazioni sui tipi di blocco. Opzioni di blocco: None Impostazione predefinita. Non viene applicato alcun blocco. Se esiste un blocco sul file per il quale si sta creando un ramo, l'opzione lo rimuove. Checkin Altri utenti possono estrarre gli elementi specificati ma non possono archiviare le revisioni nei file bloccati finché il blocco non viene rilasciato eseguendo un'archiviazione. Se altri utenti hanno bloccato uno degli elementi specificati, l'operazione di blocco non riesce. Checkout Impedisce ad altri utenti di eseguire operazioni di archiviazione o estrazione su uno degli elementi specificati finché il blocco non viene rilasciato eseguendo un'archiviazione. Se altri utenti hanno bloccato uno degli elementi specificati, l'operazione di blocco non riesce.
/noget	Se si specifica questa opzione, le copie locali dei file e delle cartella nella nuova diramazione non verranno create nell'area di lavoro locale. Tali copie locali verranno tuttavia recuperate nell'area di lavoro quando si esegue successivamente un'operazione di lettura ricorsiva. Nota: Per impedire che elementi, quali il contenuto di una cartella /images, vengano recuperati nell'area di lavoro durante operazioni ricorsive di lettura e lettura dell'ultima versione, è possibile utilizzare mascherare una cartella dell'area di lavoro. Per ulteriori informazioni, vedere Comando Workfold.
/checkin	Da utilizzare solo con la versione Service Pack 1 di Microsoft Visual Studio Team System 2008 Team Foundation Server. L'azione di diramazione viene archiviata contemporaneamente alla creazione della diramazione.
/noprompt	Non vengono visualizzati prompt che richiedono l'input da parte dell'utente.

Note

Se si specifica un percorso locale, ad esempio c:\00101, senza indicare un parametro specversione, in Team Foundation verrà utilizzata la versione locale dell'area di lavoro come base per la creazione della nuova diramazione.

Se tuttavia si specifica un percorso server, ad esempio $/00101/*.cs, senza indicare un parametro specversione, in Team Foundation verrà utilizzata l'ultima versione del server Controllo della versione di Team Foundation come base per la creazione della nuova diramazione.

Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.

Esempi

Nell'esempio riportato di seguito viene creato un file di diramazione contenente l'ultima versione dell'area di lavoro di 314.cs. Tale file, al quale viene assegnato il nome "314_branch", viene quindi salvato nella directory corrente su disco e nella cartella del server Controllo della versione di Team Foundation alla quale è mappato.

c:\projects>tf branch 314.cs 314_branch

Nell'esempio seguente vengono copiati tutti i file senza modifiche in sospeso nella versione dell'area di lavoro di 314.cs: dalla cartella corrente del server del Controllo della versione di Team Foundation nella cartella testdata del server del Controllo della versione di Team Foundation e dalla directory corrente su disco nella cartella di lavoro mappata alla cartella testdata del server del Controllo della versione di Team Foundation.

c:\projects>tf branch C:\314.cs $/testdata

Nell'esempio seguente vengono copiati tutti i file senza modifiche in sospeso nella versione corrente dell'area di lavoro della cartella testfiles e i file contenuti per tutti gli elementi dalla relativa cartella corrente del server del Controllo della versione di Team Foundation nella cartella testfiles_branch del server del Controllo della versione di Team Foundation e da c:\testfiles nella cartella locale mappata alla cartella testfiles_branch del server del Controllo della versione di Team Foundation.

c:\projects>tf branch C:\testfiles $/testfiles_branch

Nell'esempio seguente viene creata una diramazione di 314.cs come quella esistente nell'insieme di modifiche #4 per il file. Nella cartella di lavoro sul disco e nel server Controllo della versione di Team Foundation viene creato un file di diramazione denominato csharp_branch.

c:\projects>tf branch C:\314.cs;C4 csharp_branch

L'esempio riportato di seguito consente di creare una nuova diramazione di 314.cs alla data del 12.12.03. Nella cartella di lavoro sul disco e nel server Controllo della versione di Team Foundation viene creato un file di diramazione denominato 314_branch.

c:\projects>tf branch 314.cs;D12/12/03 314_branch

L'esempio riportato di seguito consente di creare una diramazione della versione di 314.cs cui è stata applicata l'etichetta "Beta1". Tale diramazione, alla quale viene assegnato il nome "Beta1branch", viene quindi salvata nella directory corrente sul disco nonché nella cartella del server Controllo della versione di Team Foundation cui è mappata la directory corrente.

c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch

Vedere anche

Attività

Procedura dettagliata: funzionalità avanzate di controllo della versione

Procedura dettagliata: utilizzo del controllo delle versioni di Team Foundation dalla riga di comando

Procedura: creare diramazioni per file e cartelle

Concetti

Informazioni sulle diramazioni

Utilizzo degli insiemi di modifiche per il controllo della versione

Riferimenti

Comando Branches

Comando Merge

Altre risorse

Comandi dell'utilità della riga di comando Tf