Shelve komutu (Team Foundation Sürüm Denetimi)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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 bir dizi değişikliği gerçekten iade etmeden depolar.

Önkoşullar

Bir raf kümesini silmek için komutunu kullanmak shelve istiyorsanız, raf kümesi sahibi olmanız veya Rafa kaldırıldı değişiklikleri yönetmeizninizin İzin Ver olarak ayarlanması gerekir. 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]

Parametreler

Bağımsız değişkenler

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 dosya 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 kapsam içindeki öğeleri belirlemek için öğesini nasıl ayrıştırdığı itemspec hakkında daha fazla bilgi için bkz. Komut işlevlerini değiştirmek için seçenekleri kullanma.
<shelvesetname> Raf kümesinin Azure DevOps sunucusundan alınabileceği bir ad belirtir. ve owner'nin var olan bir bileşimini shelvesetname belirtebilirsiniz, ancak yalnızca belirtildiyse/replace.

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> seçeneğine /login bir değer sağlar. Kullanıcı adı değerini veya usernameolarak DOMAIN\username 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 Kontrol 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 geliştirme makinenizde bekleyen değişiklikler olarak depolanır. seçeneği, /new iade etmeden önce bu iade meta verilerini temizler.
/move Rafa kaldırma 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. /server Bu seçenekle yalnızca seçenek birleştirilebilir. Seçeneği eklemezseniz /noprompt , seçenek belirtildiğinde /delete bir onay iletisi görüntülenir.
/comment Rafa alınan değişiklikleri açıklayan belirtilen bir açıklama ekler.
/recursive Belirttiğiniz bir klasörse, belirtilen raf kümesi klasöründeki tüm öğeleri, alt klasörlerini ve içindeki tüm öğeleri rafa itemspec alır.
/noprompt Sizden gelen tüm giriş istemlerini bastırır.
/validate Bu seçenek, açıldığında Shelve - Kaynak Dosyalar iletişim kutusundaki Rafa kaldırmadan önce ilkeleri ve iade notlarını değerlendir onay kutusunu 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çirme ve iade için başka biri tarafından teslim edildiğinde yararlıdır. ile /nopromptbirleştirildiğinde geçerli değil.
/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

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

Rafa kaldırma, yeterince test edilmiş bekleyen değişiklikleri iade etmeye alternatiftir. Çalışmanızı kesintiye uğratmak 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 aracıyla 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 Raftan Kaldır komutunu kullanarak rafa kaldır değişikliklerinizi geri yükleyebilirsiniz.

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

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

  • Bekleyen sürümlerin sunucudan geçerli çalışma alanına vardığı 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.

Seçeneğini eklerseniz /delete , TFVC belirtilen raf kümesini Azure DevOps sunucusundan kalıcı olarak kaldırı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.

Örnekler

Aşağıdaki örnek, Azure DevOps sunucusunda adlı Reflector_BuddyTestyeni 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şlem 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ümesini new-feature sunucudan siler, bu adla 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ündeki ve alt klasörlerindeki tüm .cs dosyalarında bekleyen tüm değişiklikleri içeren adlı HelloWorld_TestMe bir raf kümesi oluşturur:

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

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

c:\projects> tf shelve HelloWorld_24 /delete