Aracılığıyla paylaş


Shelve 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) shelve komutu, bekleyen iade notları, bir açıklama ve Azure DevOps sunucusundaki ilişkili iş öğelerinin listesiyle birlikte bekleyen değişiklikler kümesini ve bunları gerçekten iade etmeden depolar.

Önkoşullar

Raf kümesini silmek için komutunu kullanmak istiyorsanız, raf kümesi sahibi olun veya Rafa değişiklikleri yönetme izninizİzin ver olarak ayarlanmalıdır. Daha fazla bilgi için bkz. Varsayılan TFVC izinleri.

Sözdizimi

tf shelve  [/replace] [/comment:("comment"|@commentfile)] [shelvesetname] [/validate][/noprompt] [/login:username,[password]]
tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)] 
[/recursive] [shelvesetname] itemspec [/validate] [/noprompt] [/login:username,[password]]
tf shelve /delete shelvesetname[;owner] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parametre

Bağımsız değişken

Bağımsız Değişken Açıklama
<commentfile> Raf kümesi açıklamalarının okunması gereken dosyanın dosya sistemi yolunu belirtir.
<comment> Raf kümesi için açıklamayı belirtir.
<itemspec> Rafa atanacak dosyaları veya klasörleri tanımlar. Varsayılan olarak, bu parametre belirtilmezse geçerli çalışma alanında bekleyen tüm değişiklikler rafa kaldırılır. Team Foundation'ın hangi öğelerin kapsam içinde olduğunu belirlemek için nasıl ayrıştırdığı hakkında daha fazla bilgi için bkz. Komut işlevlerinindeğiştirme seçeneklerini kullanma .
<shelvesetname> Raf kümesinin Azure DevOps sunucusundan alınabileceği bir ad belirtir. var olan bir shelvesetname ve ownerbirleşimini belirtebilirsiniz, ancak yalnızca /replace belirtilirse.

Bu parametre için bir değer sağlamanız gerekir.
<owner> Raf kümesinin geçerli veya hedeflenen sahibini kullanıcı adına göre tanımlar. Varsayılan olarak, belirtilmemişse geçerli kullanıcıya raf kümesinin sahipliği atanır.
<username> /login seçeneğine bir değer sağlar. Kullanıcı adı değerini DOMAIN\username veya usernameolarak belirtebilirsiniz.
<TeamProjectCollectionUrl> Rafa almak istediğiniz dosyaları veya klasörleri içeren proje koleksiyonunun URL'si, örneğin http://myserver:8080/tfs/DefaultCollection/.

Seçenekler

Seçenek Açıklama
/new Visual Studio İade Et iletişim kutusunda gösterildiği gibi bekleyen her değişikliğin seçili durumu, açıklama, ilişkili iş öğeleri, iade notları ve iade etme ilkesi geçersiz kılma nedeni, siz iade edene kadar bekleyen değişiklikler olarak geliştirme makinenizde depolanır. /new seçeneği, iade etmeden önce bu iade meta verilerini temizler.
/move Raf işlemi başarılı olduktan sonra bekleyen değişiklikleri çalışma alanından kaldırır.
/replace Mevcut raf kümesini belirttiğiniz adla ve sahiple değiştirir.
/delete Belirtilen raf kümesini siler. Bu seçenekle yalnızca /server seçeneği birleştirilebilir. /noprompt seçeneğini eklemezseniz, /delete seçeneği belirtildiğinde bir onay iletisi görüntülenir.
/comment Rafa alınan değişiklikleri açıklayan belirtilen bir açıklama ekler.
/recursive Sağladığınız itemspec bir klasörse, belirtilen raf kümesi klasöründeki tüm öğeleri, alt klasörlerini ve içindeki tüm öğeleri rafa alır.
/noprompt Sizden gelen tüm giriş istemlerini gizler.
/validate Bu seçenek, Shelve - Kaynak Dosyalar iletişim kutusundaki rafa kaldırmadan önce Değerlendirme ilkelerini ve iade notlarını seçer. Doğrulama onay kutusu seçildiğinde, iletişim kutusu iade ilkelerini değerlendirir ve iade notlarının doldurulduğunu doğrular. Bu seçenek, değişiklikler gözden geçirilsin ve başka biri tarafından iade edilmeye bırakıldığında kullanışlıdır. /nopromptile birleştirildiğinde geçerli değildir.
/login Azure DevOps Server ile kullanıcının kimliğini doğrulamak için kullanıcı adını ve parolayı belirtir.
/collection Proje koleksiyonunu belirtir.

Açıklamalar

tf komut satırı yardımcı programının shelve komutu bekleyen değişiklikleri, ilişkili iş öğelerinin listesini, devam eden iade notlarını ve Açıklamaları Azure DevOps sunucusundaki raf kümesinde yedekler. raf kümesi, sunucuya kaydedilmemiş bir değişiklik kümesine çok benzer. Değişiklik kümesi gibi, raf kümesi de sunucudan yerel çalışma alanına yeterli izinlere sahip olan herhangi bir kullanıcı tarafından alınabilir.

Rafa kaldırma, yeterince test edilmedi bekleyen değişiklikleri iade etmeye alternatiftir. Çalışmanızı şu şekilde kesmek istediğinizde rafa kaldırmayı kullanın:

  • Sürüm denetimi sunucusunda yaptığınız değişiklikleri denetlemeden bir dizi yerel çalışma dosyasını başka bir geliştirici veya testçiyle paylaşın.

  • Bekleyen bir grup değişikliği iade etmeden geçici olarak ayırarak daha yüksek öncelikli bir sorun üzerinde çalışabilirsiniz. Yüksek öncelikli görev üzerinde çalışmayı tamamladıktan sonra rafa kaldır komutunu kullanarak rafa kaldırılmış değişikliklerinizi geri yükleyebilirsiniz.

seçeneğini eklerseniz, komutu rafa kaldırılan her dosya düzeltmesini sunucudan geçerli çalışma alanına alınan son sürüm temel çalışma alanı sürümüne geri alır. Özellikle, rafa eklediğiniz tüm öğeler için /move seçeneği:

  • Rafa alınan değişiklikleri geri almak için Undo kullanır. Bekleyen eklemeler olan dosyalar çalışma alanından silinir.

  • Bekleyen sürümlerin sunucudan geçerli çalışma alanına var olduğu tüm dosyaların temel çalışma alanı sürümlerini alır.

  • Geçerli çalışma alanında bulunan tüm öğeleri salt okunur olarak işaretler.

/delete seçeneğini eklerseniz, TFVC belirtilen raf kümesini Azure DevOps sunucusundan kalıcı olarak kaldırır.

tf komut satırı yardımcı programını kullanma hakkında daha fazla bilgi için bkz. Team Foundation sürüm denetimi komutlarını kullanma.

Örnekler

Aşağıdaki örnek, Azure DevOps sunucusunda Reflector_BuddyTestadlı yeni bir raf kümesi oluşturur, sahipliğini kullanıcıya Patatar, geçerli çalışma alanında bulunan tüm öğeleri son get işlemi sırasında indirilen en son sürüme döndürür ve salt okunur bir durum ayarlar:

c:\projects> tf shelve Reflector_BuddyTest;Pat /move

Aşağıdaki örnek, mevcut raf kümesi new-feature sunucudan siler, bu ada göre yeni bir raf kümesi oluşturur ve geçerli çalışma alanında bekleyen tüm değişiklikleri korur:

c:\projects> tf shelve new-feature /replace

Aşağıdaki örnek, C:\projects çalışma klasöründe ve alt klasörlerinde bekleyen tüm .cs dosyalarını içeren HelloWorld_TestMe adlı bir raf kümesi oluşturur:

c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive

Aşağıdaki örnek HelloWorld_24 raf kümesini siler:

c:\projects> tf shelve HelloWorld_24 /delete