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ı, 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

Bir raf kümesini silmek için komutunu kullanmak shelve istiyorsanız raf kümesi sahibi olmanız veya Yönetici ister rafa kaldırılmış değişiklikler izninizin İ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 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 öğ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öğesinin var olan bir bileşimini shelvesetname belirtebilirsiniz, ancak yalnızca aynı zamanda belirtilmişse/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 bekleyen değişiklikler olarak geliştirme makinenizde depolanır. seçeneği, /new 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. /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 Belirtilen raf kümesi klasöründeki tüm öğeleri, alt klasörlerini ve sağladığınız klasör bir klasörse itemspec içindeki tüm öğeleri rafa alır.
/noprompt Sizden gelen tüm giriş istemlerini gizler.
/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çirilsin ve başka biri tarafından iade edilmeye bırakıldığında kullanışlıdır. ile /nopromptbirleş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

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 raf kümesindeki açıklamaları 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 Raftan Kaldır komutunu kullanarak rafa kaldır değişikliklerinizi geri yükleyebilirsiniz.

seçeneğini eklerseniz /move , komut rafa shelve kaldırılan her dosya düzeltmesini sunucudan geçerli çalışma alanına 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çeneği kullanabilirsiniz /move :

  • Rafa alınan değişiklikleri geri almak için kullanır Undo . 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.

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 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 working 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