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

2025-01-10

Azure DevOps Services'ı | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Team Foundation Sürüm Denetimi'nden (TFVC) sürüm denetimli dosyaları yok etmek veya kalıcı olarak silmek için tf destroy komutunu kullanın.

Not

Azure Devops içindeki TFVC deposunu oluşturduktan sonra silmeye izin verilmez. komut tf destroy yalnızca sürüm denetimli dosyaları veya klasörleri yok eder veya kalıcı olarak siler, ancak TFVC deposunu silmez. İletinin silindiği seçenekler listesinde görünmeye devam eder.

Bazen sürüm denetim sistemlerini temizlemeniz gerekir. Örneğin, bazı dosyalara bilgisayar virüsü bulaşmışsa, bunları sürüm denetiminden kalıcı olarak kaldırmanız gerekir. Hala gerekli olan dosyaları yok etmeyin. Yok etme eylemi geri alınamaz.

/keephistory seçeneği olmadan tf destroy çalıştırmadan önce, yok etmek istediğiniz dosyaları silin. Daha fazla bilgi için bkz. Dosya ve klasörleri sürüm denetiminden silme.

Dosyaları sildikten sonra TFVC ambarını eşitleyebilirsiniz. Aksi takdirde, ambar yok edilen öğelerle eşitlenmez.

Önkoşullar

destroy komutunu kullanmak için Team Foundation Yöneticileri güvenlik grubuna ait olun. Daha fazla bilgi için bkz. Varsayılan TFVC izinleri.

Sözdizimi

tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>...<itemspecN>] 
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]

Parametre

Bağımsız değişken

Bağımsız Değişken

Açıklama

<itemspec1> [<itemspec2>...<itemspecN>]

Yok edilecek dosya veya klasörün sunucu yolunu belirtir. Birden çok öğeyi silmek için birden çok itemspec değeri kullanın. Örneğin, tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3.

Yerel yollar desteklenmez.

<versionspec>

/keephistory veya /stopat seçenekleri için C58 gibi bir sürüm sağlar. İzin verilen değerler date, tipveya belirli bir değişiklik kümesidir. TFVC'nin kapsamı içinde hangi öğelerin olduğunu belirlemek için 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.

<username>

/login seçeneğine bir değer sağlar. DOMAIN\username veya usernameolarak bir username değeri belirtebilirsiniz.

TeamProjectCollectionUrl

Yok etmek istediğiniz dosyaları içeren proje koleksiyonunun URL'si, örneğin http://myserver:8080/tfs/DefaultCollection.

Seçenekler

Seçenek

Açıklama

/keephistory

Opsiyonel. İçeriği yok edilse bile dosyanın geçmişinin korunduğunu belirtir. Bu seçenek /preview seçeneğiyle belirtilemiyor.

/stopat

Opsiyonel. Yalnızca /keephistory de belirtildiğinde kullanılabilir.

Dosyanın dosya sürümünü ve ardından gelen ve geçmişin korunduğu dosyaları belirtir.

/stopat için varsayılan sürüm, öğenin en son iade edilmiş sürümü için tip (T) sürümüdür.

/stopat seçeneği için bir öğe belirtmek üzere etiket veya çalışma alanı versionspec değerleri kullanamazsınız.

/preview

Komut istemi penceresinde yok edilecek dosyaları görüntüler. tf destroy önizleme modunda çalıştığında, dosyalar aslında yok edilmez.

Not

Komut istemi penceresindeki metin, yok edilecek her dosyayla Yok sözcüğünü görüntüler. Ancak, dosya aslında /preview seçeneği kullanıldığında yok olmaz.

/startcleanup

Silme işlemi tamamlandıktan hemen sonra TFVC meta veri temizleme işlemini başlatmaya zorlar. Kullanıcı /startcleanupbelirtmezse, veritabanı bakımı Artık Azure DevOps Server tarafından başvurulmuyor tüm dosyaları temizlediğinde yok edilen meta veri temizleme işlemi gerçekleşir. Varsayılan olarak, temizleme beş günde bir çalışacak şekilde zamanlanır. TFVC meta verileri temizlendikten yedi gün sonra içerik başka bir temizleme işlemi tarafından silinir. Varsayılan olarak, bu içerik temizleme işlemi her gün bir kez çalıştırılır.

/noprompt veya /i

Dosyaların yok edilmesinin etkileşimli olmadığını belirtir. /i, /nopromptiçin bir diğer addır.

/silent

Dosyaları veya klasörleri yok ettiğinizde çıkışın komut istemi penceresine yazılmadığını belirtir.

/login

TFVC ile kullanıcının kimliğini doğrulamak için kullanıcı adını ve parolayı belirtir.

/collection

Proje koleksiyonunu belirtir.

Açıklamalar

Sürüm denetimi dosyalarını yok etmek için tf destroy kullandığınızda, TFVC'nin uygulama katmanı yok etme isteğini alır ve Team Foundation Yöneticileri güvenlik grubunun üyesi olup olmadığınızı denetler. Üye değilseniz, sistem işlemi gerçekleştirmek için yeterli izinlere sahip olmadığınızı bildiren bir hata iletisi iletişim kutusu görüntüler.

Sistem izinlerinizi doğruladıktan sonra destroy komutunu çalıştırır. Bu komut tüm dosya başvurularını, raf kümelerini ve bekleyen değişiklikleri siler. Kalıcı bir silme işlemi olan dosyaların gerçek yok edilmesi, Azure DevOps Server tarafından artık başvurulamayacak içerik bir sonraki temizlenişinde gerçekleşir. Ayrıca, tf destroy çalıştırıldıktan hemen sonra dosyaları temizlemek için /startcleanup seçeneğini belirtebilirsiniz.

ve belirtmeden çalıştırırsanız, sistem her değeri için Evet veya yok istemi bir konsol görüntüler. Aksi takdirde, Tümiçin Evet belirtebilirsiniz.

/keephistorybelirtmezseniz, bekleyen değişiklikler (varsa) konusunda uyaran etkileşimli bir metin istenir. Değişiklikler hakkında daha fazla bilgi edinmek istiyorsanız etkileşimli metin /preview işaret etti.
belirtirseniz, EvetYok veya Tüm metinler için Evet istenir. Evet veya Tümevet seçerseniz, yok etme işlemi başlar ve yok edilen öğelerin sunucu yolları komut istemi penceresinde görünür.

Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: ...

versionspec değerini tipolarak belirttiyseniz, komut istemi penceresinde görüntülenen sunucu yolları silme kimliklerini içerir. Örneğin, komut istemi penceresinde Destroyed: $/Test1/MyProject;X123 görünebilir.

/preview seçeneğini kullanırsanız dosyalar yok olmaz, ancak komut satırı metni yok edilecek dosyaları görüntüler. Örneğin, komut satırına tf destroy /preview $/Test1/MyProject/MyProject/Program.cs girerseniz komut penceresinde şu metin görüntülenir:

Destroyed: $/Test1/MyProject/MyProject/Program.cs

Ancak, /preview seçeneğini kullandığınız için dosya aslında yok edilmiyor.

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.

/keephistory'nin diğer sürüm denetimi işlemleri üzerindeki etkileri

Yok edilen dosyaların geçmişini korumak için /keephistory seçeneğini belirtirseniz, dosyalar aşağıdaki TFVC işlemleri tarafından yok edilmiş olarak değerlendirilir:

İçeriği değiştir. Yok edilmiş bir dosyanın içeriğini (örneğin, düzenleme veya dal) değiştirmeye çalışırsanız, sistem içeriğin yok edildiğini belirten bir hata iletisi görüntüler.
Dal, birleştirme veyaraftan kaldırma. Yok edilen öğeleri dallanmayı, birleştirmeyi veya raftan kaldırmayı denerseniz, sistem öğelerin içeriğinin yok edildiğini belirten bir hata iletisi döndürür.

Daha önce silinmiş öğeleri yok etme

Bir öğe zaten silinmişse, öğeye bir silme kimliği eklenir ve dosya adı değişikliğiyle sonuçlanır.

Tf destroy'un TFVC depo kodu araması üzerindeki etkileri

Kod arama tf destroy bildirimleri işlemez, bu nedenle TFVC depoları için tf destroy kullanıldığında arama dizinindeki dosyalar otomatik olarak silinmez. Sonuç olarak, bu dosyalar kod arama sonuçlarında görünür. Bu hayalet dosya senaryolarından kaçınmak için tf destroy işleminden önce dosyaları silin.

Örnekler

Aşağıdaki örnek a.csdosyasını kalıcı olarak siler.

tf destroy $/proj/pi/a.cs

Aşağıdaki örnek bir klasörü siler aFolder:

tf delete $/MyTeamProject/aFolder

aFoldersilinen öğeyi yok etmek için komut satırına girin:

tf destroy $/MyTeamProject/aFolder;x123

burada x123 silme kimliğidir.