Label komutu (Team Foundation Sürüm Denetimi)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Team Foundation Sürüm Denetimi (TFVC) tf label komutu, TFVC sunucusundaki bir dosya veya klasörün sürümüne etiket ekler veya bu etiketi kaldırır.
Önkoşullar
komutunu kullanmak label için Etiket izninin İzin Ver olarak ayarlanmış olması gerekir. Diğer kullanıcılar tarafından oluşturulan etiketleri değiştirmek veya silmek için Yönetici ister etiketleri izninin İzin Ver olarak ayarlanmış olması gerekir. Daha fazla bilgi için bkz . Varsayılan TFVC izinleri.
Sözdizimi
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]
Parametreler
Bağımsız değişkenler
Bağımsız değişken
Açıklama
<labelname>
Belirtilen öğelere eklenecek, değiştirebileceğiniz veya kaldırılacak etiketin adını tanımlar.
@<scope>
içinde benzersiz olduğu labelname bir TFVC sunucu dizini belirtir. Bu parametre, TFVC sunucusunun farklı bölümlerinde aynı ada ait iki etiket olduğunda bir etiketi veya etiketlenmiş öğe kümesini bağımsız olarak oluşturmanıza, yönetmenize, almanıza ve silmenize olanak tanır.
<ownername>
veya juango /owner gibi DOMAIN\JuanGo bir değer sağlar.
<itemspec>
Etiketleyebileceğiniz, yeniden etiketleyebileceğiniz veya değiştireceğiniz dosyayı veya klasörü tanımlar. TFVC'nin hangi öğelerin kapsam içinde olduğunu belirlemek için öğesini nasıl ayrıştırdığı itemspec hakkında daha fazla bilgi için bkz . Team Foundation sürüm denetimi komutlarını kullanma.
Not
Birden itemspec fazla bağımsız değişken belirtebilirsiniz.
<versionspec>
seçeneği gibi c2 /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>
Etiket hakkında kullanıcı tarafından sağlanan bir açıklama.
@<commentfile>
Etiket için kullanılacak açıklamayı içeren disk üzerindeki bir dosyanın kullanıcı tarafından sağlanan yolu.
<username>
seçeneğine /login bir değer sağlar. Kullanıcı adı değerini veya usernameolarak DOMAIN\username belirtebilirsiniz.
<TeamProjectCollectionUrl>
Etiket eklemek istediğiniz veya etiketi silmek istediğiniz bir dosya veya klasörün sürümünü içeren belirtilen proje koleksiyonunun URL'si, örneğin http://myserver:8080/tfs/DefaultCollection.
Seçenekler
Seçenek
Açıklama
/owner
Etiketin sahibi olan kullanıcının adını belirtir.
/version
isteğe bağlı. Etiketin eklenmesi, değiştirilmesi veya etiketin kaldırılması gereken dosya veya klasörün sürümünü belirtir. Bunlar değişiklik kümesi değerleridir, örneğin, C93. Varsayılan olarak, sağlanmayan versionspec TFVC temel çalışma alanı sürümünü kullanır.
/comment
Etiket için açıklama veya açıklama ekler veya değiştirir.
/child
Belgelenmedi.
/recursive
dizindeki ve versionspecile itemspec eşleşen tüm öğeleri etiketler. seçeneğiyle /delete kullanılamaz.
/delete
Etiketi kaldırır.
/login
Azure DevOps ile kullanıcının kimliğini doğrulamak için kullanıcı adını ve parolayı belirtir.
/collection
Proje koleksiyonunu belirtir.
Açıklamalar
Etiket, TFVC sunucusundaki ilişkisiz dosya ve klasörler kümesine ekleyebileceğiniz bir işaretçidir. Geliştirme veya derleme amacıyla çalışma alanına dosya ve klasör alımını basitleştirmek için etiketini kullanın. Etiket, rastgele olarak dosya ve klasör ekleyip kaldırabileceğiniz veya içindeki öğelerin sürümlerini değiştirebileceğiniz bir değişiklik kümesi veya tarih/saat gibidir. Etiket, aşağıdaki TFVC komutlarına geçirilebilen bir sürüm belirtimidir:
Yaygın etiket türleri, , Beta2veya Release Candidate 0gibi M1kilometre taşı etiketleridir.
Etiketler sürüme özgüdür. Başka bir ifadeyle, bir dosya veya klasörün yalnızca bir sürümüne etiket ekleyebilirsiniz. Bir öğenin her sürümü birden çok etiketi destekleyebilir.
Etiket, sürümlenmiş bir nesne değildir. Bu nedenle, dosyaların etiket geçmişi izlenmez. Ayrıca, bir etiket işlemi çalışma alanınızda bekleyen bir değişiklik oluşturmaz. Komutu gönderdiğinizde label , güncelleştirme hemen TFVC sunucusuna yansıtılı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.
Etiketleri kaldırma ve silme
Dosya veya klasörden etiket kaldırmak için Etiket Kaldır komutunu kullanabilirsiniz. Alternatif olarak, komutunu kullanarak tf label /delete bir etiketi sistemden silebilirsiniz.
Etiketin eklendiği öğelerin listesini, açıklamasını, kapsamını ve sahibini içeren mevcut bir etiket hakkında bilgi için bkz . Etiketler komutu.
Aşırı yüklenmiş etiketleri yönetme
Etiket adları belirtilen kapsam boyunca benzersiz olmalıdır. Bir etiket eklediğinizde, bu etiket adının belirtilen veya örtük kapsamda veya altında kullanılmasını ayırırsınız. Parametresinin @scope varsayılan değeri projedir; örneğin, $/TeamProject1.
Başka bir ekip veya kullanıcı TFVC sunucusunun farklı bir bölümündeki sürüm denetimli dosyalar kümesine gibi M3 ortak bir etiket eklerse, kök proje klasörleri farklı dizinlerde olduğu sürece etiketi projenizdeki sürüm denetimli dosyalara uygulayabilirsiniz M3 . Örneğin, $/math dizinindeki dosyalar etiketliyseM3, etiketi $/projects dizininizdeki dosyalara da uygulayabilirsinizM3.
Etiketli öğelerinizi M3almak, kaldırmak veya başka bir şekilde yönetmek için, TFVC'ye hangi M3 etiketle çalışmak istediğinizi bildirmek için parametresini belirtmeniz @scope gerekir.
Team Foundation sürüm denetim sunucusunun kökünde $/ etiketinizi oluşturarak veya belirli klasörler için Etiket izinlerini ayarlayarak diğer kullanıcıların TFVC sunucusunun farklı bölümlerindeki gibi M3 bir etiketi "aşırı yüklemesini" engelleyebilirsiniz.
Örnekler
Aşağıdaki örnek, etiketi docs klasörünün çalışma alanı sürümüne ve içerdiği dosya ve klasörlere eklergoodbuild.
c:\projects>tf label goodbuild docs /recursive
Aşağıdaki örnek etiketi docs klasörüne ekler ancak docs klasörünün içerdiği dosya ve klasörlere eklemezgoodbuild.
c:\projects>tf label goodbuild docs
Aşağıdaki örnek, etiketi TFVC sunucusundaki 314.cs sürüm 3'e eklergoodbuild.
c:\projects>tf label goodbuild /version:3 $/src/314.cs
Aşağıdaki örnek, etiketi TFVC sunucusundaki tüm öğelerden siler badbuild .
c:\projects>tf label /delete badbuild
Aşağıdaki örnek, 314.cs etiket uygulamak için kapsam seçeneğini kullanır@.
c:\projects>tf label goodbuild@$/TeamProject1 314.cs