Perintah Riwayat (Kontrol Versi Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Perintah Kontrol Versi Team Foundation (TFVC) tf history menampilkan riwayat revisi satu atau beberapa file atau folder. Data perintah ditampilkan di jendela Riwayat di Visual Studio, atau jika /noprompt opsi ditentukan, pada prompt perintah.

Anda juga dapat menggunakan Visual Studio untuk mendapatkan riwayat revisi. Untuk informasi selengkapnya, lihat Mendapatkan riwayat item.

Prasyarat

Lihat Izin TFVC default.

Sintaks

tf hist[ory] itemspec [/version:versionspec] 
[/stopafter:number] [/recursive] [/user:username] 
[/format:(brief|detailed)] [/slotmode] [/itemmode] [/noprompt]
[/login:username,[password]] [/sort:ascending,descending]
[/collection:TeamProjectCollectionUrl]

Parameter

Parameter

Keterangan

/collection:<TeamProjectCollectionUrl>

Menentukan URL kumpulan proyek yang berisi item. Misalnya: http://myserver:8080/tfs/DefaultCollection.

Secara default, koleksi proyek dianggap sebagai yang berisi ruang kerja yang memetakan direktori saat ini.

/format

Menentukan berapa banyak detail yang akan ditampilkan tentang setiap set perubahan saat /noprompt opsi ditentukan:

  • Brief (default): Menampilkan satu baris tentang setiap set perubahan yang mencakup: nomor ID, perubahan yang dibuat, pengguna yang membuat perubahan, tanggal, dan komentar. Beberapa data mungkin terpotong.

  • Detailed: Menampilkan deskripsi lengkap dari setiap set perubahan. Selain informasi sebelumnya, opsi ini menampilkan lebih banyak data seperti tanggal dengan waktu, item yang diubah, catatan check-in, dan peringatan kebijakan check-in.

/itemmode

Anda tidak dapat menggabungkan opsi ini dengan /slotmode opsi . Untuk informasi selengkapnya, lihat Matt Mitrik: Mengubah ke Mode Slot di Kontrol Versi TFS 2010.

<itemspec>

Menentukan item yang akan ditampilkan riwayatnya. Untuk sintaks, lihat Menggunakan perintah kontrol versi Team Foundation.

/noprompt

Menyembunyikan tampilan jendela dan kotak dialog, seperti jendela Riwayat , dan mengalihkan data output ke prompt perintah. Lihat Menggunakan perintah kontrol versi Team Foundation.

Tidak menampilkan riwayat revisi yang terjadi sebelum item dipindahkan, diganti namanya, dicabangkan, atau digabungkan.

/login:<username>[,<password>]

Menentukan akun pengguna untuk menjalankan perintah. Lihat Menggunakan perintah kontrol versi Team Foundation.

/recursive

Secara rekursif mengambil data historis pada item di direktori yang ditentukan dan subdirektori apa pun.

/slotmode

Anda tidak dapat menggabungkan opsi ini dengan /itemmode opsi . Untuk informasi selengkapnya, lihat Matt Mitrik: Mengubah ke Mode Slot di Kontrol Versi TFS 2010.

/sort

Mengurutkan riwayat revisi untuk satu atau beberapa file atau folder dalam salah satu urutan berikut:

  • Ascending: Dari revisi terlama hingga terbaru.

  • Descending (default): Dari yang terbaru ke revisi terlama.

Anda harus menggunakan /noprompt opsi dengan opsi ini.

/stopafter:<number>

Menentukan jumlah maksimum set perubahan yang akan ditampilkan dalam data riwayat.

/user:<username>

Memfilter data historis untuk menampilkan perubahan yang dibuat oleh pengguna yang ditentukan. Simbol tanda bintang (*) menyertakan data tentang perubahan dari semua pengguna, defaultnya.

/version:<versionspec>

Menentukan versi maksimum, atau versi minimum dan maksimum dengan menggunakan sintaks rentang ~ . Defaultnya adalah /version:W, versi di ruang kerja.

Anda tidak dapat menggabungkan opsi ini dengan /slotmode opsi .

Untuk sintaks, lihat Menggunakan perintah kontrol versi Team Foundation.

Keterangan

  • Untuk mendapatkan informasi lebih rinci tentang set perubahan, misalnya untuk melihat item kerja terkait:

    • Di jendela Riwayat Visual Studio, klik dua kali atau klik kanan set perubahan dan pilih Ubah Detail Set.

    • Dari prompt perintah, gunakan perintah Changeset.

  • Opsi /collection ini berguna untuk menjalankan perintah ini dari komputer dan akun pengguna yang tidak memiliki ruang kerja yang dipetakan ke koleksi proyek yang berisi item.

Contoh

Contoh berikut mengasumsikan bahwa c:\code\SiteApp\Main maps ke folder utama di ruang kerja.

Mendapatkan riwayat satu file

Contoh berikut menampilkan semua perubahan yang dibuat pada program2.cs di jendela Riwayat .

c:\code\SiteApp\Main\SolutionA\Project1>tf history program2.cs

Contoh berikut menampilkan semua perubahan yang dilakukan pada program2.cs di jendela prompt perintah.

c:\code\SiteApp\Main\SolutionA\Project1>tf history program2.cs /noprompt

Output:

Changeset Change                     User              Date       Comment
--------- -------------------------- ----------------- ---------- -------- 
29        edit                       Jamal Hartnett    4/23/2012  Fix bug
20        add                        Raisa Pokrovskaya 4/12/2012  Add new

Mendapatkan riwayat semua item dalam folder

Contoh berikut menampilkan semua perubahan yang dilakukan pada semua item di SolutionA, termasuk yang ada di subfolder, di jendela Riwayat .

c:\code\SiteApp\Main\SolutionA>tf history * /recursive

Mendapatkan riwayat lima perubahan terakhir ke semua item dalam folder

Contoh berikut menampilkan lima perubahan terbaru yang dibuat pada item di SolutionA, termasuk yang ada di subfolder, di jendela prompt perintah:

c:\code\SiteApp\Main\SolutionA>tf history * /noprompt /recursive /stopafter:5

Output:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
31        Raisa Pokrovskaya 5/15/2012
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to Proje
15        Raisa Pokrovskaya 4/8/2012

Mendapatkan riwayat dari versi x dan yang lebih lama

Contoh berikut menampilkan perubahan yang dilakukan pada semua item di SolutionA, termasuk yang ada di subfolder, di versi 30 dan yang lebih lama, di jendela prompt perintah:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:30

Output:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to 
15        Raisa Pokrovskaya 4/8/2012

Mendapatkan riwayat dari tanggal D dan yang lebih lama

Contoh berikut menampilkan perubahan yang dilakukan pada semua item di SolutionA, termasuk yang ada di subfolder, pada 23/4/12 atau yang lebih lama, di jendela prompt perintah:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/24/2012

Atau:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D2012-04-24T12:00

Output:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to 15        Raisa Pokrovskaya 4/8/2012

Mendapatkan riwayat dari rentang tanggal

Contoh berikut menampilkan perubahan yang dilakukan pada semua item di SolutionA, termasuk yang ada di subfolder, antara 12/4/2012 dan 23/4/2012, di jendela prompt perintah:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012

Output:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to

Dapatkan riwayat terperinci

Contoh berikut menampilkan detail tentang perubahan yang dilakukan pada semua item di SolutionA, termasuk yang ada di subfolder, antara 12/4/2012 dan 23/4/2012, di jendela prompt perintah:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012 /format:detailed

Output:

-------------------------------------------------------------------------------
Changeset: 30
User: Raisa Pokrovskaya (Fabrikam)
Date: Monday, April 23, 2012 1:23:05 PM

Comment:
  Much better name for this file

Items:
  rename                $/SiteApp/Main/SolutionA/Project1/programBig.cs
  delete, source rename $/SiteApp/Main/SolutionA/Project1/program3.cs;X15

-------------------------------------------------------------------------------
Changeset: 29
User: Raisa Pokrovskaya (Fabrikam)
Date: Monday, April 23, 2012 1:03:13 PM

Comment:
  Fix bug in new method

Items:
  edit $/SiteApp/Main/SolutionA/Project1/program1.cs
  edit $/SiteApp/Main/SolutionA/Project1/program2.cs

-------------------------------------------------------------------------------
Changeset: 20
User: Raisa Pokrovskaya (Fabrikam)
Date: Thursday, April 12, 2012 5:09:35 PM

Comment:
  Add new method, add program2.cs to Project1

Items:
  add $/SiteApp/Main/SolutionA/Project1/program2.cs

Check-in Notes:
  Documentation:
    An important new part of our codebase.

Policy Warnings:
  Override Reason:
    Jamal agrees with me that we can bypass for this check-in.
  Messages:
    The Code Analysis Policy requires files to be checked in through Visual
Studio with an open solution.

Mendapatkan riwayat folder yang tidak rekursif

Contoh berikut menampilkan riwayat folder SolutionA di jendela Riwayat Visual Studio, yang memungkinkan Anda menjelajahi perubahan sebelumnya ke folder. Misalnya, jika perubahan terbaru ke folder adalah ganti nama, Anda dapat memperluas set perubahan untuk melihat perubahan yang terjadi sebelum mengganti nama.

c:\code\SiteApp\Main\SolutionA>tf history .

Contoh berikut menampilkan perubahan terbaru ke folder SolutionA di jendela prompt perintah.

c:\code\SiteApp\Main\SolutionA>tf history . /noprompt