Aracılığıyla paylaş

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

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

Visual Studio 2019 | Visual Studio 2022

TFVC branch komutu, meta veriler ve sürüm denetimi geçmişi dahil olmak üzere bir öğeyi veya öğe kümesini Azure DevOps sunucusunda ve yerel çalışma alanında 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. Ekibin kod tabanında çalışmanızı denetleme.

Önkoşullar

komutunu kullanmak için kaynak öğe için Okuma iznine ve hedef klasör için kullanıma alma ve Birleştirme izinleriniİzin Ver olarak ayarlanmış . 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]

Parametre

Tartışma

Bağımsız Değişken Açıklama
<olditem> Dallandırılan kaynak dosyanın veya klasörün adını belirtir. <olditem> item;versionbiçiminde sürüm bilgileri de içerebilir.
<newitem> Hedef dosyanın veya klasörün veya hedef için üst klasörün adını belirtir. <*newitem> zaten 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> /version seçeneği için bir değer sağlar. TFVC'nin kapsamı içinde hangi öğelerin olduğunu belirlemek için 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> /author seçeneği için kullanıcı tarafından sağlanan değer.
<username> /login seçeneğine bir değer sağlar. kullanıcı adı değerini DOMAIN\username veya <username>olarak 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
    Temerrüt. 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

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

/noprompt

Sizden gelen tüm giriş istemlerini gizler.

/silent

/nogetanlamına gelir ve bir dal oluşturduğunuzda çıkışın komut istemi penceresine yazılacağı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 /checkin seçeneğiyle kullanılır.

/author

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

/recursive

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

Açıklamalar

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

Ancak, $/00101/*.cs gibi bir sunucu yolu belirtirseniz ve belirtmezseniz, TFVC bunun yerine yeni dalı oluşturmak için temel olarak en son Azure DevOps Server sürümünü kullanır.

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

Örnekler

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

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

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

Aşağıdaki örnek, 314.cs çalışma alanı sürümünde bekleyen düzenleme yapılmadan tüm dosyaları geçerli Azure DevOps Server klasöründeki 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:\testfilestestfiles_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ı 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 yeni bir 314.cs dalı oluşturur. Azure DevOps sunucusunda olduğu gibi diskteki çalışma klasöründe 314\branch başlıklı bir dal dosyası oluşturulur.

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

Aşağıdaki örnek, etiketinin uygulandığı 314.cs sürümünü dallar, beta1brancholarak 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