Bagikan melalui

Perintah label (Kontrol Versi Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Perintah Team Foundation Version Control (TFVC) tf label melampirkan label ke atau menghapus label dari versi file atau folder di server TFVC.

Prasyarat

Untuk menggunakan label perintah , Anda harus memiliki izin Label yang diatur ke Izinkan. Untuk mengubah atau menghapus label yang dibuat oleh pengguna lain, Anda harus memiliki izin Mengelola label yang diatur ke Izinkan. Untuk informasi selengkapnya, lihat Izin TFVC default.

Sintaks

tf label labelname[@scope] [/owner:ownername] 
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)] 
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]	

tf label /delete labelname[@scope] 
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parameter

Argumen

Argumen

Keterangan

<labelname>

Mengidentifikasi nama label untuk melampirkan, mengubah, atau menghapus dari item yang ditentukan.

@<scope>

Menentukan direktori server TFVC yang labelname unik. Parameter ini memungkinkan Anda membuat, mengelola, mengambil, dan menghapus satu label atau set item berlabel secara independen ketika dua label dengan nama yang sama berada di bagian yang berbeda dari server TFVC.

<ownername>

Menyediakan nilai seperti DOMAIN\JuanGo atau hanya juango untuk /owner opsi .

<itemspec>

Mengidentifikasi file atau folder untuk memberi label, memberi label ulang, atau memodifikasi. Untuk informasi selengkapnya tentang cara TFVC mengurai itemspec untuk menentukan item mana yang berada dalam cakupan, lihat Menggunakan perintah kontrol versi Team Foundation.

Catatan

Anda dapat menentukan lebih dari satu itemspec argumen.

<versionspec>

Menyediakan nilai seperti c2 untuk /version opsi . 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>

Komentar yang disediakan pengguna tentang label.

@<commentfile>

Jalur file yang disediakan pengguna pada disk yang berisi komentar yang akan digunakan untuk label.

<username>

Menyediakan nilai untuk /login opsi . Anda dapat menentukan nilai nama pengguna sebagai DOMAIN\username atau username.

<TeamProjectCollectionUrl>

URL koleksi proyek yang ditentukan yang berisi versi file atau folder tempat Anda ingin melampirkan label atau dari mana Anda ingin menghapus label, misalnya http://myserver:8080/tfs/DefaultCollection.

Opsi

Opsi

Keterangan

/owner

Menentukan nama pengguna yang memiliki label.

/version

Opsional. Menentukan versi file atau folder tempat label harus dilampirkan, dimodifikasi, atau dari mana label harus dihapus. Ini adalah nilai set perubahan, misalnya, C93. Secara default, TFVC menggunakan versi ruang kerja dasar jika tidak versionspec disediakan.

/comment

Menambahkan atau memodifikasi deskripsi atau komentar untuk label.

/child

Tidak didokumenkan.

/recursive

Melabeli semua item dalam direktori yang cocok dengan Anda itemspec dan versionspec. Tidak dapat digunakan dengan /delete opsi .

/delete

Menghapus label.

/login

Menentukan nama pengguna dan kata sandi untuk mengautentikasi pengguna dengan Azure DevOps.

/collection

Menentukan koleksi proyek.

Keterangan

Label adalah penanda yang dapat Anda lampirkan ke sekumpulan file dan folder yang tidak terkait di server TFVC. Gunakan label untuk menyederhanakan pengambilan file dan folder ke ruang kerja untuk tujuan pengembangan atau build. Label seperti set perubahan atau tanggal/waktu di mana dan dari mana Anda dapat secara segan-segan menambahkan dan menghapus file dan folder atau mengubah versi item di dalamnya. Label adalah spesifikasi versi yang dapat diteruskan ke perintah TFVC berikut:

Jenis label umum adalah label tonggak pencapaian seperti M1, , Beta2atau Release Candidate 0.

Label bersifat khusus versi. Artinya, Anda hanya dapat melampirkan label ke satu versi file atau folder. Setiap versi item dapat mendukung beberapa label.

Label bukan objek berversi. Oleh karena itu, riwayat label file tidak dilacak. Selain itu, operasi label tidak membuat perubahan tertunda di ruang kerja Anda. Ketika Anda mengeluarkan label perintah, pembaruan segera tercermin di server TFVC.

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

Menghapus dan menghapus label

Anda dapat menggunakan perintah Unlabel untuk menghapus label dari file atau folder. Atau, Anda dapat menghapus label dari sistem dengan menggunakan tf label /delete perintah .

Untuk informasi tentang label yang sudah ada yang menyertakan daftar item tempat label telah dilampirkan, komentar, cakupan, dan pemiliknya, lihat Perintah label.

Mengelola label yang kelebihan beban

Nama label harus unik di seluruh cakupan tertentu. Saat menambahkan label, Anda memesan penggunaan nama label tersebut pada atau di bawah cakupan yang ditentukan atau tersirat. Nilai default untuk @scope parameter adalah proyek, misalnya, $/TeamProject1.

Jika tim atau pengguna lain menambahkan label umum seperti M3 ke sekumpulan file yang dikontrol versi di bagian lain dari server TFVC, Anda dapat menerapkan M3 label ke file yang dikontrol versi dalam proyek Anda selama folder proyek akar berada di direktori yang berbeda. Misalnya, jika file dalam direktori $/math diberi M3label , Anda juga dapat menerapkan M3 label ke file di direktori $/projects Anda.

Untuk mendapatkan, menghapus label, atau mengelola item berlabel Anda M3, Anda harus menentukan @scope parameter untuk memberi tahu TFVC label mana yang M3 ingin Anda kerjakan.

Anda dapat mencegah pengguna lain "kelebihan beban" label seperti M3 di berbagai bagian server TFVC dengan membuat label Anda di akar $/ server kontrol versi Team Foundation atau dengan menyesuaikan izin Label untuk folder tertentu.

Contoh

Contoh berikut melampirkan goodbuild label ke versi ruang kerja folder dokumen dan file dan folder yang ada di dalamnya.

c:\projects>tf label goodbuild docs /recursive

Contoh berikut melampirkan goodbuild label ke folder dokumen tetapi tidak ke file dan folder yang dikandung folder dokumen.

c:\projects>tf label goodbuild docs

Contoh berikut melampirkan goodbuild label ke versi 3 314.cs di server TFVC.

c:\projects>tf label goodbuild /version:3 $/src/314.cs

Contoh berikut menghapus badbuild label dari semua item di server TFVC.

c:\projects>tf label /delete badbuild

Contoh berikut menggunakan @ opsi cakupan untuk menerapkan label ke 314.cs.

c:\projects>tf label goodbuild@$/TeamProject1 314.cs