Branch komutu (Team Foundation Sürüm Denetimi)

  • Makale

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

TFVC branch komutu, Azure DevOps sunucusunda ve yerel çalışma alanında meta veriler ve sürüm denetimi geçmişi dahil olmak üzere bir öğeyi veya öğe kümesini bir konumdan diğerine kopyalar.

Not

Bu komutun sonuçları, siz bir iade işlemi gerçekleştirene kadar Azure DevOps sunucusuna yansıtılmaz. Daha fazla bilgi için bkz . Ekibinizin kod tabanında çalışmanızı iade etme.

Önkoşullar

komutunu kullanmak branch için kaynak öğe için Okuma izninizin olması ve hedef klasör için Kullanıma Al ve Birleştir izinlerinin İzin Ver olarak ayarlanmış olması gerekir. Daha fazla bilgi için bkz . Varsayılan TFVC izinleri.

Sözdizimi

tf branch olditem newitem [/version:versionspec] [/noget] [/lock:(none|checkin|checkout)] [/noprompt] [/silent] [/checkin] [/comment:("comment"|@commentfile)] [/author:authorname] [/login:username, [password]] [/recursive]

Parametreler

Bağımsız değişken

Bağımsız değişken Açıklama
<olditem> Dallandırılan kaynak dosyanın veya klasörün adını belirtir. biçiminde <olditem> sürüm bilgileri item;versionde içerebilir.
<newitem> Hedef dosyanın veya klasörün veya hedef için üst klasörün adını belirtir. Zaten <*newitem> varsa ve bir Azure DevOps Server klasörüyse, TFVC içinde dallandırılmış öğeleri oluşturur. Aksi takdirde, <newitem> hedef dosya veya klasörün adını belirtir. Hedef zaten varsa iade sırasında çakışmalar oluşabilir.
<versionspec> seçeneği için /version bir değer sağlar. TFVC'nin kapsamı içinde hangi öğelerin olduğunu belirlemek için bir sürüm belirtimini nasıl ayrıştırdığı hakkında daha fazla bilgi için bkz . Team Foundation sürüm denetimi komutlarını kullanma.
<comment> Dal hakkında bir açıklama sağlar.
@<commentfile> Dal için kullanılan açıklamayı içeren dosyanın yolunu belirtir.
<authorname> Seçeneği için /author kullanıcı tarafından sağlanan değer.
<username> seçeneğine /login bir değer sağlar. Kullanıcı adı değerini veya <username>olarak DOMAIN\username belirtebilirsiniz.

Seçenek

Seçenek

Açıklama

/version

Dalını oluşturmak istediğiniz öğenin sürümü. Bir sürümü şu şekilde belirtebilirsiniz:

  • Tarih/saat (D10/20/2005)
  • Değişiklik kümesi numarası (C1256)
  • Etiket (Lmylabel)
  • En son sürüm (T)
  • Çalışma Alanı (Wworkspacename)

Sürüm sağlanmadıysa, TFVC öğenin yeni dala kopyalanacak sürümüne karar vermek için aşağıdaki mantığı kullanır:

  • Azure DevOps Server yolu belirtilirse, TFVC öğeyi en son Azure DevOps Server sürümünde dallar. Örneğin, tf branch $/projects/help.cs sunucu sürümünü kullanır.
  • Kaynak için yerel bir yol belirtilirse, TFVC yeni dalı oluşturmak için yerel çalışma alanı sürümünü kullanır. Örneğin, tf branch C:\314.cs yerel çalışma alanı sürümünü kullanır.

Çalışma alanı sürümü Azure DevOps sunucusundaki en son sürümden eski olan bir dosyayı dallandırıyorsanız, dosya eski sürümde dallandırılır.

/lock

Siz bekleyen dalınızı ve ilişkili değişiklikleri iade edene kadar diğer kullanıcıların öğeleri iade etmesini veya kullanıma almalarını engeller. Daha fazla bilgi için bkz . Kilit Türlerini Anlama.

Kilit seçenekleri:

  • none
    Varsayılan. Hiçbir kilit uygulanmaz. Dalını oluşturduğunuz dosyada bir kilit varsa, bu seçenek bu kilidi kaldırır.
  • checkin
    Diğer kullanıcılar belirtilen öğeleri kullanıma alabilir, ancak siz bir iade işlemi gerçekleştirerek kilidi serbest bırakana kadar kilitli dosyalardaki düzeltmeleri iade yapamazlar. Diğer kullanıcılar belirtilen öğelerden herhangi birini kilitlemişse, kilitleme işlemi başarısız olur.
  • checkout
    Siz bir iade işlemi gerçekleştirerek kilidi serbest bırakana kadar diğer kullanıcıların belirtilen öğelerden herhangi birini iade etmesini veya kullanıma almalarını engeller. Diğer kullanıcılar belirtilen öğelerden herhangi birini kilitlemişse, kilitleme işlemi başarısız olur.

/noget

Bu seçenek belirtilirse, yeni daldaki dosya ve klasörlerin yerel kopyaları yerel çalışma alanında oluşturulmaz. Ancak, özyinelemeli alma işlemini bir sonraki gerçekleştirdiğinizde yerel kopyalar çalışma alanına alınır.

Not

Bir çalışma alanı klasörünü gizleyerek özyinelemeli alma ve en son işlemleri alma sırasında /images klasörünün içeriği gibi öğelerin çalışma alanınıza alınmasını engelleyebilirsiniz. Daha fazla bilgi için bkz . Workfold Komutu.

/noprompt

Sizden gelen tüm giriş istemlerini gizler.

/silent

/nogetöğesini gösterir ve bir dal oluşturduğunuzda çıkışın komut istemi penceresine yazılmadığını belirtir.

/checkin

Tek bir işlemde dalda sunucuda oluşturur ve denetler. Bu seçenek, yerel çalışma alanında bekleyen hiçbir değişiklik oluşturmaz.

/comment

Yeni dala açıklama ekler. Bu seçenek yalnızca seçeneğiyle /checkin kullanılır.

/author

Yeni dalın yazarını tanımlar. Bu seçenek yalnızca seçeneğiyle /checkin kullanılır.

/recursive

Klasörler için, içindeki tüm dosyaları da dallar.

Açıklamalar

c:\00101 gibi bir yerel yol belirtir ancak belirtmezseniz<versionspec>, TFVC yeni dalı oluşturmak için temel olarak yerel çalışma alanı sürümünü kullanır.

Bununla birlikte, $/00101/*.cs gibi bir sunucu yolu belirtir ve belirtmezseniz<versionspec>, TFVC bunun yerine yeni dalı oluşturmak için en son Azure DevOps Server sürümünü kullanır.

Komut satırı yardımcı programını kullanma tf hakkında daha fazla bilgi için bkz . Team Foundation sürüm denetimi komutlarını kullanma.

Örnekler

Aşağıdaki örneklerde, çalışma alanında ana klasöre eşlendiği varsayılır c:\projects .

Aşağıdaki örnek, 314.cs'nin en son çalışma alanı sürümünü içeren, 314_branch olarak adlandıran ve disk üzerindeki geçerli dizine ve ayrıca eşlendiği Azure DevOps Server klasörüne kaydeden bir dal dosyası oluşturur.

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

Aşağıdaki örnek, 314.cs çalışma alanı sürümünde bekleyen düzenlemeler olmadan tüm dosyaları geçerli Azure DevOps Server klasöründen testdata Azure DevOps Server klasörüne ve diskteki geçerli dizinden testdata Azure DevOps Server klasörüne eşleyen çalışma klasörüne kopyalar.

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

Aşağıdaki örnek, testfiles klasörünün geçerli çalışma alanı sürümünde bekleyen düzenlemeler olmadan tüm dosyaları ve geçerli Azure DevOps Server klasöründeki tüm öğeler için içerdiği dosyaları testfiles_branch Azure DevOps Server klasörüne ve c:\testfiles dosyasından testfiles_branch Azure DevOps Server klasörüne eşleyen yerel klasöre kopyalar.

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

Aşağıdaki örnek, dosya için değişiklik kümesi #4'te mevcut olduğu için 314.cs dalını oluşturur. Diskteki çalışma klasöründe, Azure DevOps sunucusunda olduğu gibi, csharp_branch adlı bir dal dosyası oluşturulur.

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

Aşağıdaki örnek, 12.12.03 tarihinde olduğu gibi 314.cs yeni bir dalı oluşturur. Azure DevOps sunucusunda olduğu gibi diskteki çalışma klasöründe 314\branch adlı bir dal dosyası oluşturulur.

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

Aşağıdaki örnek, etiketin uygulandığı 314.cs Beta1 sürümünü dallar, Beta1branch olarak adlandırılır ve geçerli dizinin eşlendiği Azure DevOps Server klasörüne ek olarak diskteki geçerli dizine kaydeder.

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