Bagikan melalui

Perintah Ruang Kerja (Kontrol Versi Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

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

Prasyarat

  • Untuk memodifikasi atau menghapus ruang kerja yang sudah ada, jadilah pemilik atau atur izin ruang kerja Administer global ke Izinkan.
  • Untuk membuat ruang kerja, minta Membuat ruang kerja izin yang diatur ke Izinkan.
  • Untuk membuat ruang kerja bagi pengguna lain, mintalah Mengelola ruang kerja izin yang diatur ke Izinkan.

Untuk informasi selengkapnya, lihat izin TFVC Default.

Sintaksis

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 perintah workspace.

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 opsi /computer.
<comment> Menyediakan nilai untuk opsi /comment.
@<comment-file> Menentukan jalur file tempat komentar harus dibaca.
<username> Menyediakan nilai untuk opsi /login. Anda dapat menentukan nilai ini sebagai DOMAIN\<username> atau <username>.
<password> Menyediakan nilai untuk opsi /login.
<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 opsi /newowner.

Pilihan

Pilihan 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. Nilai ini adalah 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.

Komentar

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 utilitas baris perintah tf, 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 dev 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 dari opsi /new. 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. Gunakan perintah get 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 di kotak dialog Tambahkan Ruang Kerja, misalnya, . 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.

Menghapus 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.

Nota

Perintah yang berjalan secara manual memerlukan opsi /noprompt untuk melewati pengakuan pengguna. Berhati-hatilah jika Anda menggunakan metode Start() PowerShell 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 workspace untuk mengambil nilai tersebut. Untuk informasi selengkapnya, lihat perintah ruang kerja. Untuk menemukan nilai <workspace-owner>, jalankan perintah berikut:

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

Untuk menemukan nilai <workspace-name>, gunakan nilai <OwnerId> dari output perintah sebelumnya sebagai nilai <workspace-owner>. 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. 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