Bagikan melalui


Perintah Ruang Kerja (Kontrol Versi Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

Perintah Team Foundation Version Control (TFVC) workspace menyediakan cara bagi Anda untuk membuat, menghapus, melihat, atau memodifikasi properti dan pemetaan yang terkait dengan ruang kerja.

Prasyarat

  • Untuk mengubah atau menghapus ruang kerja yang ada, Anda harus menjadi pemilik atau memiliki izin Mengelola ruang kerja global yang diatur ke Izinkan.
  • Untuk membuat ruang kerja, Anda harus mengatur izin Buat ruang kerja global ke Izinkan.
  • Untuk membuat ruang kerja untuk pengguna lain, Anda harus mengatur izin Kelola ruang kerja ke Izinkan.

Untuk informasi selengkapnya, lihat Izin TFVC default.

Sintaks

tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]
tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]
tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]

Parameter

Bagian berikut ini menjelaskan argumen dan opsi workspace perintah.

Argumen

Argumen Deskripsi
<workspace-name> Menentukan nama untuk ruang kerja yang ingin Anda buat, edit, hapus, atau tampilkan informasi tentang.
<workspace-owner> Menentukan nama pengguna untuk ruang kerja. Parameter ini diperlukan ketika pemilik ruang kerja bukan orang yang melakukan perintah.
<computer-name> Menyediakan nilai untuk /computer opsi .
<comment> Menyediakan nilai untuk /comment opsi .
@<comment-file> Menentukan jalur file tempat komentar harus dibaca.
<username> Menyediakan nilai untuk /login opsi . Anda dapat menentukan nilai ini sebagai DOMAIN\<username> atau <username>.
<password> Menyediakan nilai untuk /login opsi .
<team-project-collection-url> URL kumpulan proyek yang berisi ruang kerja yang ingin Anda buat, edit, hapus, atau tampilkan informasi tentang, misalnya, https://myserver:8080/tfs/DefaultCollection.
<owner-name> Menyediakan nilai untuk /newowner opsi .

Opsi

Opsi Deskripsi
/new Membuat ruang kerja baru.
/template Menentukan ruang kerja yang sudah ada untuk digunakan sebagai templat untuk membuat ruang kerja baru. Ruang kerja baru menggunakan pemetaan ruang kerja yang ada.
/delete Menghapus ruang kerja yang ditentukan.
/computer Menentukan nama komputer tempat membuat ruang kerja. Opsi ini adalah opsi lanjutan.
/comment Menyediakan komentar yang menjelaskan ruang kerja.
/newname Mengganti nama ruang kerja yang sudah ada.
/noprompt Melakukan perintah ruang kerja yang ditentukan tanpa menampilkan kotak dialog.
/collection Menentukan koleksi proyek.
/permission Menentukan opsi untuk izin ruang kerja:

    - Private: Hanya pemilik yang dapat menggunakan, memeriksa file ke, atau mengelola ruang kerja.


    - Public Limited: Setiap pengguna yang valid dapat menggunakan ruang kerja. Tetapi hanya pemilik yang dapat memeriksa file ke atau mengelola ruang kerja.


    - Public: Setiap pengguna yang valid dapat menggunakan, memeriksa file ke, atau mengelola ruang kerja.


/location Menentukan tempat ruang kerja dibuat:

    - local: Pada komputer klien. Ini adalah nilai default.


    - server: Di server Azure DevOps.


/login Menentukan nama pengguna dan kata sandi untuk mengautentikasi pengguna dengan Azure DevOps.
/newowner Menentukan nama pengguna untuk pemilik baru ruang kerja.

Keterangan

Ruang kerja adalah salinan lokal file dan folder di server, ditambah perubahan apa pun yang telah Anda buat secara lokal. Saat Anda menambahkan, mengedit, menghapus, memindahkan, mengganti nama, atau mengubah item yang dikontrol versi apa pun, perubahan Anda terisolasi di ruang kerja, tempat Anda dapat membuat dan menguji perubahan Anda. Saat Anda memeriksa pekerjaan Anda ke basis kode tim, Anda menerapkan perubahan Anda ke server. Mereka tersedia untuk pengguna lain yang berada di luar ruang kerja Anda.

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

Membuat ruang kerja

Sebelum dapat menambahkan file ke server kontrol versi atau memeriksa item di server, Anda harus membuat ruang kerja atau mengaitkan file yang sudah ada dengan direktori saat ini. Untuk informasi selengkapnya, lihat Menyiapkan Kontrol Versi Team Foundation di komputer pengembangan Anda.

Untuk menjadikan direktori saat ini sebagai folder kerja untuk ruang kerja yang sudah ada di komputer Anda, ikuti langkah-langkah berikut:

  1. Masukkan tf workspace <workspace-name>, di mana <workspace-name> adalah nama ruang kerja yang ada. Kotak dialog Edit Ruang Kerja muncul.
  2. Pilih klik di sini untuk memasukkan folder kerja baru.
  3. Dalam kotak Folder Kontrol Sumber, masukkan jalur server yang ingin Anda petakan direktorinya saat ini.
  4. Dalam kotak Folder Lokal, masukkan direktori saat ini.
  5. Pilih OK.

Saat membuat ruang kerja baru, Anda dapat menentukan ruang kerja templat sebagai bagian /new dari opsi. Saat Anda menentukan ruang kerja templat, TFVC membuat ruang kerja baru di komputer saat ini. TFVC juga mengatur pemilik ke pemilik saat ini dan mereplikasi properti ruang kerja berikut ke ruang kerja baru dari ruang kerja templat: mappings dan comment. Jika tidak ada nama yang ditentukan, sistem menggunakan nama yang didasarkan pada nama komputer saat ini. Saat Anda membuat ruang kerja dengan menggunakan templat, TFVC tidak mengambil file yang dipetakannya dari server. get Gunakan perintah untuk menyinkronkan ruang kerja baru dengan versi terbaru di server. Untuk informasi selengkapnya, lihat Perintah dapatkan.

Pemetaan folder tunggal

Anda dapat memilih untuk memetakan hanya turunan langsung dari folder kontrol versi ke ruang kerja lokal. Untuk melakukan ini, tambahkan karakter kartubebas tanda bintang (*) di kotak Folder Kontrol Sumber dalam kotak dialog Tambahkan Ruang Kerja, misalnya, $/folder/* . Jika tidak, secara default, semua turunan folder kontrol versi dipetakan secara rekursif ke ruang kerja lokal.

Pemetaan folder tunggal dalam hierarki kontrol versi berguna karena membatasi jumlah item yang diunduh ke komputer klien. Cara lain untuk membatasi file yang diunduh adalah dengan menyelubungi file yang tidak perlu Anda miliki di ruang kerja Anda. Untuk informasi selengkapnya, lihat Mengoptimalkan ruang kerja Anda. Pendekatan ini menyediakan waktu pengunduhan yang lebih cepat dan menghemat ruang disk pada komputer klien.

Hapus ruang kerja

Jika Anda menghapus ruang kerja yang berisi perubahan yang tertunda, TFVC membatalkan perubahan yang tertunda sebagai bagian dari proses penghapusan. Menghapus ruang kerja tidak menghapus file dan folder di komputer klien yang ada di ruang kerja tersebut.

Catatan

Perintah yang berjalan secara manual memerlukan /noprompt opsi untuk melewati pengakuan pengguna. Berhati-hatilah jika Anda menggunakan metode PowerShell Start() untuk menjalankan perintah. Opsi /noprompt dapat diatur secara otomatis di PowerShell.

Saat menghapus ruang kerja, Anda perlu menyediakan <workspace-owner> dan <workspace-name>

Anda dapat menggunakan perintah untuk mengambil nilai-nilai tersebut workspace . Untuk informasi selengkapnya, lihat perintah ruang kerja. Untuk menemukan nilainya <workspace-owner> , jalankan perintah berikut:

c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml

Untuk menemukan <workspace-name> nilai, gunakan <OwnerId> nilai dari output perintah sebelumnya sebagai <workspace-owner> nilai . Nilai tersebut memiliki format ID objek Azure Active Directory (Azure AD) diikuti dengan garis miring terbalik dan nama utama pengguna. Gunakan seluruh nilai. Kemudian, jalankan perintah berikut:

c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`

Untuk menghapus ruang kerja, jalankan perintah berikut:

c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`

Mengedit ruang kerja

Anda dapat mengubah atribut ruang kerja berikut:

  • Nama ruang kerja
  • Komentar
  • Pemetaan folder kerja

Jika tidak ada spesifikasi ruang kerja yang disediakan, ruang kerja untuk folder saat ini digunakan.

Contoh

Contoh berikut membuka kotak dialog Tambahkan Ruang Kerja dan membuat ruang kerja baru. Anda bisa menggunakan kotak dialog Tambahkan Ruang Kerja untuk mengedit folder kontrol sumber, pemilik, komputer, komentar, dan folder lokal.

c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection

Contoh berikut membuat ruang kerja baru yang disebut Beta1 dan menetapkan jenh sebagai pemilik ruang kerja. Anda harus memiliki izin AdminWorkspaces untuk menetapkan kepemilikan ruang kerja baru kepada pengguna lain. Untuk informasi selengkapnya tentang izin keamanan, lihat Izin TFVC default.

c:\projects>tf workspace /new Beta1;jenh

Contoh berikut membuat ruang kerja baru dengan menggunakan ruang kerja Beta1 yang dimiliki oleh jenh sebagai templat:

c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection

Contoh berikut menghapus ruang kerja Beta1 dari server:

c:\projects>tf workspace /delete Beta1

Contoh berikut mengedit properti untuk ruang kerja saat ini:

c:\projects>tf workspace

Contoh berikut membuka ruang kerja Beta1 yang dimiliki oleh jenh sehingga Anda dapat melihat properti dan pemetaannya. Jika Anda memiliki izin AdminWorkspaces , Anda dapat mengubah properti dan pemetaan ruang kerja.

c:\projects> tf workspaces Beta1;jenh