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:
- Masukkan
tf workspace <workspace-name>, di mana<workspace-name>adalah nama ruang kerja yang ada. Kotak dialog Edit Ruang Kerja muncul. - Pilih klik di sini untuk memasukkan folder kerja baru.
- Dalam kotak Folder Kontrol Sumber, masukkan jalur server yang ingin Anda petakan direktorinya saat ini.
- Dalam kotak Folder Lokal, masukkan direktori saat ini.
- 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