Label Komutu (Team Foundation Sürüm Denetimi)
Team Foundation sürüm denetimi için sunucusundaki bir dosyanın veya klasörün sürümüne bir etiketi iliştirir veya ondan etiketi kaldırır.
Gerekli İzinler (bu sayfa İngilizce içeriğe sahip olabilir)
label komutunu kullanmak için, Etiket izninizin İzin ver'e ayarlanmış olması gerekir. Diğer kullanıcıların oluşturduğu etiketleri değiştirmek ya da silmek için, Etiketleri yönet izninizin İzin ver'e ayarlanmış olması gerekir. Daha fazla bilgi için bkz. Takım Kuruluş Sunucusu İzinleri.
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şken |
Açıklama |
---|---|
labelname |
Belirtilen öğelere iliştirilecek, onlardan kaldırılacak veya değiştirilecek etiketin adını saptar. |
@scope |
Etiket adının eşsiz olduğu bir Team Foundation sürüm denetimi sunucu dizini belirtir. Bu parametre, aynı adın iki etiketi Team Foundation sürüm denetimi sunucusunun farklı bölümlerinde olduğu zaman, bağımsız bir şekilde bir etiketi veya etiketli öğeler kümesini oluşturmanıza, almanıza ve silmenize olanak sağlar. |
ownername |
/owner seçeneğine DOMAIN\JuanGo or just juango gibi bir değer sağlar. |
itemspec |
Etiketlenecek, yeniden etiketlenecek veya değiştirilecek dosyayı veya klasörü belirtir. Hangi öğelerin kapsamda olduğunu belirlemek için itemspec'lerin Team Foundation tarafından nasıl ayrıştırdığı hakkında daha fazla bilgi için bkz. Komut Satırı Sözdizimi (Sürüm Denetimi).
Not
Birden fazla Itemspec bağımsız değişkeni belirtebilirsiniz.
|
versionspec |
/version seçeneği için c2 gibi bir değer sağlar. Hangi öğelerin kapsamında olduğunu belirlemek için bir sürüm tanımlamasının Team Foundation tarafından nasıl ayrıştırıldığı hakkında daha fazla bilgi için bkz. Komut Satırı Sözdizimi (Sürüm Denetimi). |
comment |
Etiket hakkında kullanıcı tarafından sağlanan bir açıklama. |
@commentfile |
Diskteki bir dosyanın kullanıcıdan sağlanan yolu iade etmede kullanılacak yorumunu içerir. |
username |
/login seçeneğine bir değer sağlar. Bir kullanıcı adı değerini DOMAIN\UserName veya UserName olarak belirtebilirsiniz. |
TeamProjectCollectionUrl |
Bir etiket eklemek istediğiniz veya (örneğin, http://myserver:8080/tfs/DefaultCollection) bir etiketi silmek istediğiniz bir dosyanın veya klasörün sürümünü içeren belirtilmiş takım projesi koleksiyonunun URL'sidir. |
Seçenek |
Açıklama |
---|---|
/owner |
Etiketin sahibi olan kullanıcının adını belirtir. |
/version |
İsteğe Bağlı. Etiketin iliştirilmesi, değiştirilmesi veya 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, Team Foundation, versionspec belirtilmemişse temel çalışma alanı sürümünü kullanır. |
/comment |
Etiket için bir tanımlama veya açıklama ekler veya değiştirir. |
/child |
Belirttiğiniz etiketle aynı olan önceden mevcut etiketlere sahip öğelerle nasıl uğraşılacağını saptar. Varolan etikete karşılık gelen öğenin sürümünü güncellemek için Replace kullanın. Öğeleri varolan etiketle tek başına bırakmak için Merge kullanın. |
/recursive |
Dizinde itemspec ve versionspec parametrelerinizle eşleşen bütün öğeleri etiketler. /delete seçeneğiyle kullanılamaz. |
/delete |
Etiketi kaldırır. |
/login |
Visual Studio Team Foundation Server ile kullanıcının kimliğini doğrulamak için kullanıcı adı ve parolayı belirtir. |
/collection |
Takım projesi koleksiyonunu belirtir. |
Açıklamalar
Bir etiket, Team Foundation sürüm denetimi sunucusunda alakasız bir dosyalar ve klasörler kümesine iliştirebileceğiniz bir işaretleyicidir. Geliştirme veeya yapı amaçları için bir çalışma alanına alınmalarını basitleştirmek üzere etiketi kullanın. Bundan dolayı, bir etiket rasgele dosyaları ekleyebildiğiniz ve kaldırabildiğinz veya öğelerin sürümlerini değiştirebildiğiniz bir değişiklik kümesi veya tarih/zaman gibidir. Bir etiket aşağıdaki Team Foundation komutlarına geçirilebilecek sürüm açıklamasıdır:
Ortak etiket türleri, "M1," "Beta2," or "Release Candidate 0." gibi kilometre taşı etiketleridir.
Etiketler sürüme özgüdür, yani bir dosya veya klasörün bir sürümüne sadece bir tane etiket iliştirebilirsiniz. Bir öğenin her sürümü birçok etiketi destekleyebilir.
Etiket sürümlenmiş bir nesne değildir; bundan dolayı dosyaların etiket geçmişi izlenmez. Ek olarak, etiket işlemi çalışma alanınızda bekleyen bir değişiklik oluşturmaz. label komutunu çıkarırsanız, güncelleme hemen Team Foundation sürüm denetimi sunucusunda yansıtılır.
tf komut satırı yardımcı programı hakkında daha fazla bilgi için, bkz: Tf Komut Satırı Yardımcı Uygulama Komutları
Etiketleri Kaldırma ve Silme
Unlabel Komutu bağlanıtısını bir etiketi dosyadan veya klasörden kaldırmakta kullanabilirsiniz. Alternatif olarak, tf label /delete komutunu kullanarak bir etiketi sistemden silebilirsiniz.
Etiketin iliştirildiği öğelerin bir listesini, o etiketin açıklamasını, kapsamını ve sahibini içeren mevcut bir etiket hakkında daha fazla bilgi için, bkz. Labels Komutu.
Aşırı Yüklenmiş Etiketleri Yönetmek
Etiket adları belirlenmiş bir kapsam boyunca eşsiz olmalıdır. Bir etiket eklediğinizde, belirtilen veya ima edilen kapsamda veya onun altında o etiket adını kullanma hakkını alırsınız. @scope parametresi için varsayılan değer takım projesidir, örneğin, $/TeamProject1.
Diğer bir takım veya kullanıcı "M3" gibi ortak bir etiketi ,Team Foundation sürüm denetimi sunucusunun farklı bir bölümündeki sürümü denetlenmiş dosyalar kümesine eklerse, kök proje klasörleri farklı dizinlerde olduğu sürece M3 etiketini projenizdeki sürümü denetlenmiş dosyalara uygulayabilirsiniz. Örneğin, $/math dizinindeki dosyalar "M3" olarak etiketlenmişse, "M3"ü $/projects dizininizdeki dosyalara uygulayabilirsiniz.
Bir etiketi almak, silmek veya M3 etiketli öğeleri yönetmek için, @scope parametresini Team Foundation'a hangi M3 etiketiyle çalışmak istediğinizi bildirmek için belirtmelisiniz.
Etiketinizi Team Foundation sürüm denetimi sunucusunun kökü ($/) şeklinde oluşturarak ya da belirli klasörler için Etiket izinlerini ayarlayarak, kullanıcıların Team Foundation sürüm denetimi sunucusunun farklı bölümlerindeki "M3" gibi bir etiketi aşırı yüklemesini engelleyebilirsiniz.
/Child Seçeneğini Etiketleme Yanlışlıklarından Sakınmak için Kullanma
label komutunu önceden varolan bir etiket adıyla ve aynı etiketle işaretlenmiş dosyaları içeren itemspec ile kullanırsanız, /child seçeneğinin değeri, işaretlenmiş dosyaların yeni gözden geçirme bilgisiyle güncellenmesini belirler. Bu demektir ki, dosyalar aynı adla etiketlenmiştir ama farklı kapsamları vardır.
Örneğin, 314.cs ve 271.cs diye iki dosyayı içeren c:\projects adında bir klasörünüzün olduğunu varsayın. Ayrıca 314.cs'in C70 sürümünün "hazır" diye etiketlendiğini varsayın. 314.cs'in en son sürümü C93'tür. Aşağıdaki komutu kullanarak "ready" etiketini klasörün ve onun içerdiği dosyaların en son sürümüne uygularsanız, "ready" etiketi 314.cs;C70'ten 314.cs;C93'e taşınır.
tf label ready c:\projects /recursive /version:T /child:Replace
Diğer taraftan, mevcut "ready" etiketini 314.cs için C70 sürümünden C93 sürümüne taşımak istiyorsanız, aşağıdaki sözdizimini kullanırsınız:
tf label ready c:\projects /recursive /version:T /child:Merge
Merge'ü /child seçeneği için değer olarak belirttiğinizde, sözkonusu etiketin önceden varolan örnekleri yalnız bırakılır.
Not
Yukarıdaki iki örnekte versionspec'in en son sürümünü almak üzere T "Tip" için kullanılır.
Örnekler
Aşağıdaki örnek "goodbuild" etiketini "docs" klasörünün çalışma alanı sürümüne ve onun içerdiği dosyalara ve klasörlere iliştirir.
c:\projects>tf label goodbuild docs /recursive
Aşağıdaki örnek "goodbuild" etiketini "docs" klasörünün çalışma alanı sürümüne iliştirir ama onun içerdiği dosyalara ve klasörlere iliştirmez.
c:\projects>tf label goodbuild docs
Aşağıdaki örnek "goodbuild" etiketini Team Foundation sürüm denetimi sunucusunda 314.cs'in sürüm 3'üne iliştirir.
c:\projects>tf label goodbuild /version:3 $/src/314.cs
Aşağıdaki örnek "badbuild" etiketini Team Foundation sürüm denetimi sunucusundaki bütün öğelerden siler.
c:\projects>tf label /delete badbuild
Aşağıdaki örnek kapsam seçeneğini 314.cs'e etiket uygulamak için kullanır.
c:\projects>tf label goodbuild@$/TeamProject1 314.cs
Ayrıca bkz.
Başvuru
Komut Satırı Sözdizimi (Sürüm Denetimi)
Kavramlar
Dosyalarınızın Anlık Görüntüsünü Almak için Etiketleri Kullanma
Dosyalarınızın Anlık Görüntüsünü Almak için Etiketleri Kullanma