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, 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;version de 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