Bagikan melalui

Hancurkan perintah (Kontrol Versi Team Foundation)

  • Artikel

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

tf destroy Gunakan perintah untuk menghancurkan, atau menghapus file yang dikontrol versi secara permanen dari Team Foundation Version Control (TFVC).

Catatan

Menghapus repositori TFVC di dalam Azure Devops tidak diizinkan setelah dibuat. Perintah tf destroy hanya akan menghancurkan, atau menghapus secara permanen, file atau folder yang dikontrol versi tetapi tidak akan menghapus repositori TFVC. Ini masih akan muncul dalam daftar opsi dengan pesan yang dihapus.

Terkadang Anda harus membersihkan sistem kontrol versi. Misalnya, jika beberapa file terinfeksi virus komputer, Anda harus menghapusnya secara permanen dari kontrol versi. Jangan hancurkan file yang masih diperlukan. Tindakan penghancurkan tidak dapat dibalik.

Sebelum Anda menjalankan tf destroy tanpa opsi , pertama-tama /keephistory hapus file yang ingin Anda hancurkan. Untuk informasi selengkapnya, lihat Menghapus file dan folder dari kontrol versi.

Setelah menghapus file, Anda dapat menyinkronkan gudang TFVC. Jika tidak, gudang tidak akan disinkronkan dengan item yang dihancurkan.

Prasyarat

Untuk menggunakan destroy perintah , Anda harus termasuk dalam grup keamanan Administrator Team Foundation. Untuk informasi selengkapnya, lihat Izin TFVC default.

Sintaks

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

Parameter

Argumen

Argumen

Keterangan

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

Menentukan jalur server file atau folder yang akan dihancurkan. Gunakan beberapa itemspec nilai untuk menghapus beberapa item. Contohnya,tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3.

Jalur lokal tidak didukung.

<versionspec>

Menyediakan versi seperti C58 untuk /keephistory opsi atau /stopat . Nilai yang diizinkan adalah date, tip, atau set perubahan tertentu. Untuk informasi selengkapnya tentang cara TFVC mengurai spesifikasi versi untuk menentukan item mana yang berada dalam cakupannya, lihat Menggunakan perintah kontrol versi Team Foundation.

<username>

Menyediakan nilai untuk /login opsi . Anda dapat menentukan username nilai sebagai DOMAIN\username atau username.

TeamProjectCollectionUrl

URL kumpulan proyek yang berisi file yang ingin Anda hancurkan, misalnya, http://myserver:8080/tfs/DefaultCollection.

Opsi

Opsi

Keterangan

/keephistory

Opsional. Menentukan bahwa riwayat file dipertahankan bahkan saat isinya dihancurkan. Opsi ini tidak dapat ditentukan dengan /preview opsi .

/stopat

Opsional. Hanya dapat digunakan jika /keephistory ditentukan juga.

Menentukan versi file untuk file, dan file yang mengikuti setelahnya, yang riwayatnya dipertahankan.

Versi default untuk /stopat adalah tip (T) untuk versi check-in terbaru item.

Anda tidak dapat menggunakan nilai label atau ruang versionspec kerja untuk menentukan item untuk opsi tersebut /stopat .

/preview

Menampilkan file yang akan dihancurkan di jendela prompt perintah. Saat tf destroy dijalankan dalam mode pratinjau, file tidak benar-benar dihancurkan.

Catatan

Teks di jendela prompt perintah menampilkan kata Dihancurkan dengan setiap file yang akan dihancurkan. Namun, file sebenarnya tidak dihancurkan ketika /preview opsi digunakan.

/startcleanup

Memaksa proses pembersihan metadata TFVC dimulai segera setelah penghapusan selesai. Jika pengguna tidak menentukan /startcleanup, proses pembersihan metadata yang dihancurkan terjadi ketika pemeliharaan database membersihkan semua file yang tidak lagi direferensikan oleh Azure DevOps Server. Secara default, pembersihan dijadwalkan untuk berjalan setiap lima hari. Tujuh hari setelah metadata TFVC dibersihkan, konten dihapus oleh proses pembersihan lain. Secara default, proses pembersihan konten ini berjalan sekali setiap hari.

/noprompt atau /i

Menentukan bahwa penghancuran file tidak interaktif. /i adalah alias untuk /noprompt.

/silent

Menentukan bahwa, saat Anda menghancurkan file atau folder, output tidak ditulis ke jendela prompt perintah.

/login

Menentukan nama pengguna dan kata sandi untuk mengautentikasi pengguna dengan TFVC.

/collection

Menentukan koleksi proyek.

Keterangan

Ketika Anda menggunakan tf destroy untuk menghancurkan file kontrol versi, tingkat aplikasi TFVC menerima permintaan penghancurkan dan pemeriksaan untuk melihat apakah Anda anggota grup keamanan Administrator Team Foundation. Jika Anda bukan anggota, sistem menampilkan kotak dialog pesan kesalahan yang memberi tahu Anda bahwa Anda tidak memiliki izin yang memadai untuk melakukan operasi.

Setelah sistem memverifikasi izin Anda, sistem menjalankan perintah hancurkan. Perintah ini menghapus semua referensi file, shelveset, dan perubahan yang tertunda. Penghancuran file yang sebenarnya, yang merupakan penghapusan permanen, terjadi lain kali konten yang tidak lagi direferensikan oleh Azure DevOps Server dibersihkan. Anda juga dapat menentukan /startcleanup opsi untuk membersihkan file segera setelah tf destroy dijalankan.

Jika Anda menjalankan tf destroy tanpa menentukan /i dan /preview, sistem menampilkan konsol Ya atau Tidak perintah untuk setiap filespec nilai. Jika tidak, Anda dapat menentukan Ya untuk Semua.

  • Jika Anda tidak menentukan /keephistory, Anda akan diminta oleh teks interaktif yang memperingatkan perubahan yang tertunda, jika ada. Teks interaktif menunjuk ke /preview jika Anda ingin informasi selengkapnya tentang perubahan.

  • Jika Anda menentukan /keephistory, Anda juga diminta oleh teks Ya, Tidak, atau Ya untuk Semua . Jika Anda memilih Ya atau Ya untuk Semua, proses penghancuran dimulai, dan jalur server ke item yang dihancurkan muncul di jendela prompt perintah.

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

Jika Anda menentukan versionspec nilai sebagai tip, jalur server yang ditampilkan di jendela prompt perintah menyertakan ID penghapusan. Misalnya, Destroyed: $/Test1/MyProject;X123 mungkin muncul di jendela prompt perintah.

Jika Anda menggunakan /preview opsi , file tidak dihancurkan, tetapi teks baris perintah menampilkan file yang akan dihancurkan. Misalnya, jika Anda memasukkan tf destroy /preview $/Test1/MyProject/MyProject/Program.cs di baris perintah, jendela perintah menampilkan teks ini:

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

Namun, file sebenarnya tidak dihancurkan karena Anda menggunakan /preview opsi .

Untuk informasi selengkapnya tentang cara menggunakan tf utilitas baris perintah, lihat Menggunakan perintah kontrol versi Team Foundation.

Efek /keephistory pada operasi kontrol versi lainnya

Jika Anda menentukan /keephistory opsi untuk mempertahankan riwayat file yang dihancurkan, file diperlakukan sebagai dihancurkan oleh operasi TFVC berikut:

  • Ubah konten. Jika Anda mencoba mengubah konten file yang dihancurkan, misalnya edit atau cabang, sistem mengeluarkan pesan kesalahan yang menyatakan konten telah dihancurkan.

  • Cabang, gabungkan, atau lepaskan. Jika Anda mencoba mencabangkan, menggabungkan, atau melepaskan item yang dihancurkan, sistem mengeluarkan pesan kesalahan yang menyatakan konten item telah dihancurkan.

Menghancurkan item yang dihapus sebelumnya

Jika item telah dihapus, ID penghapusan dilampirkan ke item tersebut dan menghasilkan perubahan nama file.

Pencarian kode tidak menangani tf destroy pemberitahuan, jadi menggunakan repositori tf destroy TFVC tidak akan secara otomatis menghapus file dari indeks pencarian. Akibatnya, file-file ini muncul di hasil pencarian kode. Untuk menghindari skenario file hantu ini, hapus file sebelum tf destroy operasi.

Contoh

Contoh berikut menghapus file secara permanen a.cs.

tf destroy $/proj/pi/a.cs

Contoh berikut menghapus folder, aFolder:

tf delete $/MyTeamProject/aFolder

Untuk menghancurkan item aFolder yang dihapus, masukkan di baris perintah:

tf destroy $/MyTeamProject/aFolder;x123

di mana x123 adalah ID penghapusan.