Comando Branch
Il comando branch consente di copiare un elemento o un insieme di elementi, fra cui metadati e cronologia del controllo delle versioni, da una posizione all'altra nel server 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 Archiviare modifiche in sospeso.
Autorizzazioni necessarie
Per utilizzare il comando branch è necessario disporre dell'autorizzazione Lettura per l'elemento di origine e delle autorizzazioni Estrai e Unisci 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)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]]
Parametri
Argomento |
Oggetto di descrizione |
|---|---|
olditem |
Specifica il nome del file o della cartella di origine per la quale viene creata la creazione di un ramo. 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, Team Foundation creerà gli elementi con ramo 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 (controllo della versione). |
comment |
viene fornito un commento sul ramo. |
@commentfile |
Indica il percorso di un file contenente il commento utilizzato per il ramo. |
authorname |
Valore fornito dall'utente per l'opzione /author. |
username |
Fornisce un valore all'opzione /login. È possibile specificare un valore username come DOMINIO\NomeUtente o NomeUtente. |
Opzione |
Oggetto di descrizione |
|---|---|
/version |
Versione dell'elemento in corrispondenza della quale creare la creazione di un ramo. È possibile specificare una versione in base a:
Se non viene fornita alcuna versione, in Team Foundation viene utilizzata la seguente logica per decidere la versione dell'elemento da copiare nella nuova creazione di un ramo:
Se si crea la creazione di un ramo 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 creazione di un ramo 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 creazione di un ramo in sospeso e delle modifiche associate. Per ulteriori informazioni, vedere Informazioni sui tipi di blocco. Opzioni di blocco:
|
/noget |
Se si specifica questa opzione, le copie locali dei file e delle cartella nella nuova creazione di un ramo non verranno create nell'area di lavoro locale. Tali copie locali verranno tuttavia recuperate nell'area di lavoro quando si esegue successivamente un'operazione get ricorsiva. .gif "Nota") 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.
|
/noprompt |
Non vengono visualizzati prompt che richiedono l'input da parte dell'utente. |
/silent |
Implica /noget e consente di specificare che l'output non venga scritto nella finestra del prompt dei comandi alla creazione di un ramo. |
/checkin |
Consente di creare e archiviare il ramo nel server con una sola operazione. Questa opzione non consente di creare le modifiche in sospeso nell'area di lavoro locale. |
/comment |
Consente di aggiungere un commento al nuovo ramo. Questa opzione viene utilizzata solo con l'opzione /checkin. |
/author |
Consente di identificare l'autore del nuovo ramo. Questa opzione viene utilizzata solo con l'opzione /checkin. |
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 creazione di un ramo.
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 creazione di un ramo.
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 generato un file di creazione di un ramo, contenente l'ultima versione dell'area di lavoro di 314.cs, al quale viene assegnato il nome "314_branch". Il file viene quindi salvato nella directory corrente su disco e nella cartella del server Controllo della versione di Team Foundation a cui è 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 creazione di un ramo 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 creazione di un ramo denominato csharp_branch.
c:\projects>tf branch C:\314.cs;C4 csharp_branch
Nell'esempio seguente viene creato un nuovo ramo di 314.cs come alla data 12/12/03. Nella cartella di lavoro sul disco e nel server Controllo della versione di Team Foundation viene creato un file con ramo denominato 314_branch.
c:\projects>tf branch 314.cs;D12/12/03 314_branch
L'esempio riportato di seguito consente di creare una creazione di un ramo della versione di 314.cs cui è stata applicata l'etichetta "Beta1". Tale creazione di un ramo, 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à
Creare un ramo per file e cartelle
Riferimenti
Concetti
Utilizzo degli insiemi di modifiche