Perintah Cabang (Kontrol Versi Team Foundation)

  • Artikel

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Perintah TFVC branch menyalin item atau sekumpulan item, termasuk metadata dan riwayat kontrol versi, dari satu lokasi ke lokasi lain di server Azure DevOps dan di ruang kerja lokal.

Catatan

Hasil perintah ini tidak tercermin di server Azure DevOps hingga Anda melakukan operasi check-in. Untuk informasi selengkapnya, lihat Memeriksa pekerjaan Anda ke basis kode tim.

Prasyarat

Untuk menggunakan branch perintah, Anda harus memiliki izin Baca untuk item sumber, dan izin Cek keluar dan Gabungkan untuk folder target yang diatur ke Izinkan. Untuk informasi selengkapnya, lihat Izin TFVC default.

Sintaks

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

Parameter

Argumen

Argumen Keterangan
<olditem> Menentukan nama file atau folder sumber yang sedang dicabangkan. <olditem> mungkin juga berisi informasi versi dalam format item;version.
<newitem> Menentukan nama file atau folder tujuan atau folder induk untuk tujuan. Jika <*newitem> sudah ada dan merupakan folder Azure DevOps Server, TFVC membuat item bercabang di dalamnya. Jika tidak, <newitem> menentukan nama file atau folder tujuan. Konflik dapat terjadi selama check-in jika tujuan sudah ada.
<versionspec> Menyediakan nilai untuk opsi tersebut /version . Untuk informasi selengkapnya tentang cara TFVC mengurai spesifikasi versi untuk menentukan item mana yang berada dalam cakupannya, lihat Menggunakan perintah kontrol versi Team Foundation.
<comment> Memberikan komentar tentang cabang.
@<commentfile> Menentukan jalur file yang berisi komentar yang digunakan untuk cabang.
<authorname> Nilai yang disediakan pengguna untuk opsi tersebut /author .
<username> Menyediakan nilai untuk /login opsi . Anda dapat menentukan nilai nama pengguna sebagai DOMAIN\username atau <username>.

Opsi

Opsi

Keterangan

/version

Versi item tempat Anda ingin membuat cabang. Anda dapat menentukan versi dengan:

  • Tanggal/waktu (D10/20/2005)
  • Nomor set perubahan (C1256)
  • Label (Lmylabel)
  • Versi terbaru (T)
  • Ruang kerja (Wworkspacename)

Jika tidak ada versi yang disediakan, TFVC menggunakan logika berikut untuk memutuskan versi item mana yang akan disalin ke cabang baru:

  • Jika jalur Azure DevOps Server ditentukan, maka TFVC mencabangkan item di versi Azure DevOps Server terbaru. Misalnya, tf branch $/projects/help.cs menggunakan versi server.
  • Jika jalur lokal ditentukan untuk sumbernya, TFVC menggunakan versi ruang kerja lokal untuk membuat cabang baru. Misalnya, tf branch C:\314.cs menggunakan versi ruang kerja lokal.

Jika Anda mencabangkan file yang versi ruang kerjanya lebih lama dari versi terbaru di server Azure DevOps, file akan bercabang pada versi yang lebih lama.

/lock

Mencegah pengguna lain melakukan check-in atau check out item hingga Anda memeriksa cabang yang tertunda dan perubahan terkait. Untuk informasi selengkapnya, lihat Memahami Jenis Kunci.

Opsi kunci:

  • none
    Default. Tidak ada kunci yang diterapkan. Jika kunci ada pada file tempat Anda membuat cabang, opsi ini akan menghapusnya.
  • checkin
    Pengguna lain dapat memeriksa item yang ditentukan, tetapi mereka tidak dapat memeriksa revisi ke file terkunci hingga Anda melepaskan kunci dengan melakukan check-in. Jika ada pengguna lain yang telah mengunci salah satu item yang ditentukan, operasi penguncian gagal.
  • checkout
    Mencegah pengguna lain check-in atau memeriksa salah satu item yang ditentukan hingga Anda melepaskan kunci dengan melakukan check-in. Jika ada pengguna lain yang telah mengunci salah satu item yang ditentukan, operasi penguncian gagal.

/noget

Jika opsi ini ditentukan, salinan lokal file dan folder di cabang baru tidak dibuat di ruang kerja lokal. Namun, salinan lokal akan diambil ke ruang kerja saat Berikutnya Anda melakukan operasi get rekursif.

Catatan

Anda dapat mencegah item, seperti konten folder /images , agar tidak diambil ke ruang kerja Anda selama get rekursif dan mendapatkan operasi terbaru dengan menutup folder ruang kerja. Untuk informasi selengkapnya, lihat Perintah Workfold.

/noprompt

Menekan setiap permintaan untuk input dari Anda.

/silent

Menyiratkan /noget, dan menentukan bahwa output tidak ditulis ke jendela prompt perintah saat Anda membuat cabang.

/checkin

Membuat dan memeriksa di cabang ke server dalam satu operasi. Opsi ini tidak membuat perubahan yang tertunda di ruang kerja lokal.

/comment

Menambahkan komentar ke cabang baru. Opsi ini hanya digunakan dengan /checkin opsi .

/author

Mengidentifikasi penulis cabang baru. Opsi ini hanya digunakan dengan /checkin opsi .

/recursive

Untuk folder, cabangkan semua file di dalam juga.

Keterangan

Jika Anda menentukan jalur lokal seperti c:\00101 tetapi tidak menentukan <versionspec>, TFVC menggunakan versi ruang kerja lokal sebagai dasar untuk membuat cabang baru.

Namun, jika Anda menentukan jalur server seperti $/00101/*.cs dan tidak menentukan <versionspec>, TFVC menggunakan versi Azure DevOps Server terbaru sebagai dasar untuk membuat cabang baru sebagai gantinya.

Untuk informasi selengkapnya tentang cara menggunakan tf utilitas baris perintah, lihat Menggunakan perintah kontrol versi Team Foundation.

Contoh

Contoh berikut mengasumsikan bahwa c:\projects memetakan ke folder utama di ruang kerja.

Contoh berikut membuat file cabang yang berisi versi ruang kerja terbaru 314.cs, menamainya 314_branch, dan menyimpannya ke direktori saat ini di disk dan juga ke folder Azure DevOps Server yang dipetakannya.

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

Contoh berikut menyalin semua file tanpa pengeditan yang tertunda di versi ruang kerja 314.cs dari folder Azure DevOps Server saat ini ke folder Server Azure DevOps testdata dan dari direktori saat ini pada disk ke folder kerja yang memetakan ke folder Server Azure DevOps testdata .

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

Contoh berikut menyalin semua file tanpa pengeditan yang tertunda di versi ruang kerja folder testfiles saat ini dan file yang dikandungnya untuk semua item dari folder Azure DevOps Server saat ini ke folder testfiles_branch Azure DevOps Server dan dari c:\testfiles ke folder lokal yang memetakan ke folder Azure DevOps Server testfiles_branch .

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

Contoh berikut membuat cabang 314.cs karena ada di changeset #4 untuk file. Di folder kerja pada disk, seperti di server Azure DevOps, file cabang berjudul csharp_branch dibuat.

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

Contoh berikut membuat cabang baru 314.cs seperti pada 12/12/03. Di folder kerja pada disk seperti di server Azure DevOps, file cabang berjudul 314\branch dibuat.

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

Contoh berikut mencabangkan versi 314.cs tempat Beta1 label diterapkan, menamainya Beta1branch, dan menyimpannya ke direktori saat ini pada disk selain folder Azure DevOps Server tempat direktori saat ini dipetakan.

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