Menggunakan TFSConfig untuk mengelola Azure DevOps lokal

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Anda dapat menggunakan alat baris perintah TFSConfig untuk melakukan berbagai tindakan administratif untuk penyebaran Azure DevOps lokal Anda.

TFSConfig dapat dijalankan dari komputer mana pun di mana Azure DevOps Server telah diinstal.

Lokasi alat baris perintah

Alat baris perintah Azure DevOps dipasang di direktori /Tools dari server tingkat aplikasi Azure DevOps.

• Azure DevOps Server 2020: %programfiles%\Azure DevOps Server 2020\Tools
• Azure DevOps Server 2019: %programfiles%\Azure DevOps Server 2019\Tools
• TFS 2018: %programfiles%\Microsoft Team Foundation Server 2018\Tools
• TFS 2017: %programfiles%\Microsoft Team Foundation Server 15.0\Tools
• TFS 2015: %programfiles%\Microsoft Team Foundation Server 14.0\Tools
• TFS 2013: %programfiles%\Microsoft Team Foundation Server 12.0\Tools
• TFS 2012: %programfiles%\Microsoft Team Foundation Server 11.0\Tools
• TFS 2010: %programfiles%\Microsoft Team Foundation Server 2010\Tools

Prasyarat

Agar banyak perintah beroperasi dengan benar, TFSConfig harus dapat terhubung ke berbagai server dan layanan yang merupakan bagian dari penyebaran TFS Anda, dan pengguna yang menjalankan TFSConfig harus memiliki izin administratif untuk server dan layanan yang sama ini. Persyaratan untuk perintah tertentu akan dipanggil di bawah ini.

Banyak perintah TFSConfig harus dijalankan dari Prompt Perintah yang ditingkatkan, bahkan jika pengguna yang sedang berjalan memiliki kredensial administratif. Untuk membuka Prompt Perintah yang ditingkatkan, klik Mulai, klik kanan Prompt Perintah, lalu klik Jalankan sebagai Administrator. Untuk informasi selengkapnya, lihat Kontrol Akun Pengguna.

Anda juga dapat melakukan tindakan administratif secara interaktif menggunakan konsol administrasi untuk Azure DevOps Server. Lihat Referensi cepat terkait tugas administratif.

Mencantumkan perintah dan mendapatkan bantuan

Untuk menampilkan daftar lengkap perintah TFSConfig, gunakan perintah bantuan:

TFSConfig help

Untuk mendapatkan bantuan untuk perintah individual, gunakan perintah bantuan dan tentukan nama perintah yang Anda inginkan bantuannya. Misalnya, untuk mendapatkan bantuan untuk perintah akun :

TFSConfig help accounts

Akun

Gunakan perintah akun untuk mengelola akun layanan Azure DevOps Server ini.

• akun layanan Azure DevOps Server
• akun sumber data untuk SQL Server Reporting Services
• akun layanan Azure DevOps Proxy Server

Anda juga dapat menggunakan perintah ini untuk mengubah kepemilikan database Azure DevOps Server.

TfsConfig accounts /change|add|set|delete|updatepassword|resetowner
	[/accountType:<adminConsole|applicationTier|proxy|reportingDataSource>]
	[/account:<accountName>] [/password:<password>]
	[/sqlInstance:<serverName>] [/databaseName:<databaseName>] [/continue]

Operasi	Deskripsi
UpdatePassword	Mengubah kata sandi akun yang digunakan sebagai akun layanan. Mengubah akun yang ada dan semua accountTypes yang berjalan sebagai akun yang diberikan.
Ubah	Mengubah akun yang digunakan sebagai akun layanan. Menambahkan akun baru ke sumber daya dan grup yang diperlukan, memberikan izin yang diperlukan, lalu mengatur layanan untuk menggunakannya. Ini tidak menghapus akun lama dari sumber daya. Jika Anda tidak menggunakan opsi accountType, akun layanan untuk tingkat aplikasi akan diubah.
Tambahkan	Hanya menambahkan akun baru ke sumber daya yang diperlukan. Berguna untuk skenario NLB. Gunakan bendera lanjutan jika beberapa koleksi tidak dapat dijangkau. Tambahkan dapat dijalankan lagi nanti untuk memperbarui koleksi yang terlewat. Menambahkan akun ke grup yang diperlukan untuk menggunakan akun sebagai akun layanan.
Set	Hanya mengatur layanan untuk menggunakan akun yang sudah ditambahkan ke sumber daya. Berguna untuk skenario NLB.
Hapus	Menghapus akun dari semua sumber daya. Tindakan pencegahan harus digunakan saat menghapus akun karena dapat menyebabkan server lain mendapatkan layanan yang ditolak.
ResetOwner	Jika database dipulihkan sebagai bagian dari pemindahan, kloning, atau pemulihan bencana, pemilik database dapat beralih ke admin yang memulihkan server. Opsi ini melakukan iterasi melalui semua database dan mengatur login dbo ke pemilik saat ini.

AccountType	Deskripsi
AdminConsole	Pengguna Konsol Administrasi adalah pengguna yang telah diberikan izin minimum di berbagai sumber daya untuk menggunakan konsol.
ApplicationTier	Mengubah akun layanan di appPool untuk layanan web inti. (TFSService)
Proksi	Mengubah akun layanan di appPool untuk layanan web inti. (TFSProxy)
ReportingDataSource	Mengubah akun yang digunakan laporan untuk mengakses data pelaporan. (TFSReports)

Nilai defaultnya adalah ApplicationTier.

SqlInstance dan databaseName hanya sesuai untuk digunakan saat menambahkan akun ke database sebelum tingkat aplikasi dikonfigurasi. Ini terutama berguna dalam skenario pemulihan bencana di mana akun lain diperlukan sebelum menjalankan wizard konfigurasi AT Only.

Opsi lanjutkan digunakan saat menambahkan atau mengubah akun. Untuk operasi tersebut, akun diubah di setiap database koleksi. Jika lanjutkan disediakan, operasi akan berlanjut jika koleksi tidak dapat dijangkau. Ini dapat dijalankan lagi ketika koleksi dapat dijangkau.

Catatan

Akun harus dalam format domainName\userName. Untuk akun sistem, Anda harus menggunakan tanda kutip di sekitar nama akun lengkap (misalnya, "NT Authority\Network Service"). Akun sistem tidak memerlukan kata sandi.

Parameter	Deskripsi
Akun	Menentukan nama akun yang ingin Anda tambahkan, ubah, atau hapus dari jenis akun yang dirujuk, seperti /AccountType:ApplicationTier.
Kata sandi	Menentukan kata sandi akun layanan. Parameter ini bersifat opsional jika Anda menggunakan akun sistem atau akun yang tidak memiliki kata sandi, seperti Layanan Jaringan.
sqlInstance	Hanya digunakan dengan /ResetOwner. Menentukan nama server yang menjalankan SQL Server dan nama instans jika Anda ingin menggunakan instans selain instans default. Anda harus menentukan nama dan instans dalam format berikut: ServerName\InstanceName.
databaseName	Hanya digunakan dengan /ResetOwner. Menentukan nama database yang kepemilikannya ingin Anda ubah. Dengan menggunakan perintah ini, Anda mengatur ulang kepemilikan database yang Anda tentukan ke akun tempat Anda menjalankan perintah.
lanjutkan	Memperbarui grup apa pun yang tidak tersedia saat Anda menjalankan perintah. Opsi ini biasanya digunakan dalam skenario NLB.

Prasyarat

Untuk menggunakan perintah akun, Anda harus menjadi anggota:

• kelompok keamanan Administrator Azure DevOps
• peran sysadmin untuk semua instans SQL Server yang digunakan instans Azure DevOps Server Anda.

Jika Anda menggunakan opsi /proxy, Anda harus menjadi administrator di server proksi.

Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server.

Keterangan

Gunakan perintah akun untuk mengotomatiskan perubahan pada akun layanan, database, dan grup akun layanan Azure DevOps Server. Anda dapat mengonfigurasi akun yang telah Anda buat, tetapi Anda tidak dapat membuat akun.

Sebelum Anda mengubah domain atau grup kerja akun, akun harus memiliki Akun sensitif dan tidak dapat didelegasikan izin pada server tingkat aplikasi. Untuk informasi selengkapnya, lihat halaman ini di situs Web Microsoft: Mengaktifkan Autentikasi yang Didelegasikan.

Perintah akun mendukung penyebaran Azure DevOps Server lokal. Untuk mengubah pemilik akun akun Azure DevOps Services, lihat Mengubah kepemilikan akun.

Contoh

Ubah akun layanan sumber data untuk Reporting Services ke akun baru di domain Contoso, Contoso\NewAccount, dan kata sandi, menjadi Password.

TfsConfig accounts /change /AccountType:ReportingDataSource /Account:Contoso\NewAccount /Password:Password

Tambahkan akun sistem Layanan Jaringan ke grup akun layanan untuk Azure DevOps Server (akun sistem tidak memiliki kata sandi).

TfsConfig accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"

Ubah kepemilikan TFS_Warehouse database pada ContosoMain SQL Server dalam TeamDatabases instans bernama ke akun pengguna tempat Anda menjalankan perintah.

Catatan

Anda tidak dapat menentukan akun apa yang akan ditetapkan sebagai pemilik database saat Anda menggunakan perintah ini. Pemilik akan diatur ke akun tempat Anda menjalankan perintah.

TfsConfig accounts /ResetOwner /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_Warehouse

---

AddProjectReports

Catatan

Perintah addProjectReports tersedia dengan TFS 2017.1 dan versi yang lebih baru.

Anda menggunakan perintah addProjectReports untuk menambahkan atau menimpa laporan untuk proyek tim yang ada.

TfsConfig addProjectReports /collection:<teamProjectCollectionUrl> /teamProject:<projectName> /template:<templateName>
[/force]

Opsi	Deskripsi
collection	Wajib diisi. Koleksi URL Tim Proyek.
teamproject	Wajib diisi. Menentukan nama proyek tim.
templat	Wajib diisi. Menentukan nama templat proses. Opsi yang tersedia adalah Agile, CMMI, dan Scrum.
force	Opsional. Menentukan bahwa laporan harus ditimpa jika sudah ada.

Prasyarat

Untuk menggunakan perintah addProjectReports, Anda harus memiliki izin untuk menjalankan TFSConfig dan untuk mengunggah laporan ke Reporting Service.

Keterangan

Anda menggunakan perintah addProjectReports saat proyek Anda tidak memiliki laporan atau Anda ingin memperbarui laporan yang ditentukan untuk proses.

Anda mungkin perlu menggunakan perintah ini ketika:

• Proyek dibuat di portal Azure DevOps dan bukan dari Visual Studio
• Proyek dibuat dari Visual Studio, namun pelaporan tidak dikonfigurasi di Azure DevOps Server.

Jika Anda ingin menimpa laporan dalam proyek Anda dengan laporan default karena Anda meningkatkan Azure DevOps Server dan laporan lama dalam proyek Anda tidak lagi kompatibel, gunakan opsi /force. Jika Anda memiliki laporan yang disesuaikan, silakan buat cadangan sebelum melakukan ini.

Untuk mempelajari selengkapnya tentang menambahkan laporan ke Azure DevOps Server lokal, lihat Menambahkan laporan ke proyek.

Contoh

Contoh berikut menunjukkan cara menambahkan laporan Agile ke MyProject proyek dalam http://myTfsServer:8080/tfs/DefaultCollection koleksi proyek.

TFSConfig addProjectReports /collection:http://myTfsServer:8080/tfs/DefaultCollection /teamproject:MyProject /template:Agile

---

Autentikasi

Perintah Autentikasi mengubah protokol autentikasi jaringan yang digunakan tingkat aplikasi atau situs web proksi Azure DevOps Server.

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]

Opsi

Deskripsi

/viewAll

Menampilkan pengaturan autentikasi saat ini untuk Azure DevOps Server.

/provider: { NTLM | Negotiate }

Menentukan penyedia autentikasi yang ingin Anda konfigurasi untuk situs web.

• NTLM: Menggunakan protokol autentikasi NTML
• Negosiasi: Menggunakan protokol autentikasi Negosiasi (Kerberos)

/siteType

Menentukan situs web (tingkat aplikasi atau proksi) yang protokol autentikasi jaringannya ingin Anda ubah. Tingkat aplikasi adalah default.

Prasyarat

Untuk menggunakan perintah Autentikasi, Anda harus menjadi anggota kelompok keamanan Administrator Azure DevOps dan administrator lokal di server tingkat aplikasi atau server proksi, tergantung pada nilai opsi siteType.

Keterangan

Perintah Autentikasi digunakan oleh administrator yang ingin mengubah protokol autentikasi jaringan untuk satu atau beberapa situs web tempat Azure DevOps Server bergantung. Administrator menjalankan perintah ini dari tingkat aplikasi untuk memperbarui situs web yang memerlukan perubahan dalam protokol autentikasi jaringan mereka. Perintah mengubah properti NTAuthenticationProviders di metabase IIS.

Sebelum Anda menggunakan perintah Autentikasi untuk mengubah protokol autentikasi, Anda dapat menjalankan perintah dengan opsi /viewAll untuk melihat pengaturan yang ada.

Contoh

Contoh berikut menampilkan nilai saat ini yang ditetapkan untuk protokol autentikasi jaringan.

TFSConfig Authentication /viewAll

---

Sertifikat

Gunakan perintah sertifikat untuk mengubah bagaimana sertifikat dikonfigurasi untuk autentikasi klien dalam penyebaran Azure DevOps Server yang menggunakan HTTPS, secure sockets layer (SSL), dan sertifikat.

TfsConfig certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]

Opsi	Deskripsi
komputer	Menentukan bahwa daftar sertifikat akan berasal dari konteks komputer lokal alih-alih konteks pengguna saat ini.
nonaktifkan	Menentukan bahwa pengaturan sertifikat autentikasi klien akan dinonaktifkan.
autoSelect	Menentukan bahwa sertifikat akan dipilih secara otomatis dari daftar sertifikat. Jendela Kelola Sertifikat Klien tidak akan terbuka.
noprompt	Menentukan bahwa jendela Kelola Sertifikat Klien tidak akan terbuka saat perintah Sertifikat dijalankan.
thumbprints	Menentukan bahwa sertifikat yang cocok dengan thumbprint yang ditentukan akan digunakan. Anda dapat menentukan lebih dari satu sertifikat dengan memisahkan thumbprint individual dengan koma.

Prasyarat

Untuk menggunakan perintah sertifikat, Anda harus menjadi anggota kelompok keamanan Administrator Azure DevOps dan grup Administrator lokal di komputer tempat Anda menjalankan perintah. Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server.

Keterangan

Secara default, perintah sertifikat akan secara otomatis memilih sertifikat klien dari daftar sertifikat untuk pengguna saat ini. Namun, Anda dapat menggunakan opsi untuk perintah untuk menentukan sertifikat atau sertifikat tertentu dari konteks pengguna saat ini atau dari konteks komputer lokal.

Sebelum menggunakan perintah sertifikat, Anda harus terlebih dahulu mengonfigurasi server dalam penyebaran Azure DevOps Server untuk menggunakan sertifikat. Untuk informasi selengkapnya, lihat Menyiapkan HTTPS dengan Secure Sockets Layer (SSL) untuk Azure DevOps Server.

Anda menggunakan perintah sertifikat untuk mengonfigurasi sertifikat klien yang digunakan oleh penyebaran Azure DevOps Server yang telah dikonfigurasi untuk menggunakan HTTPS/SSL dan sertifikat. Jika Anda menggunakan perintah Sertifikat tanpa opsi, sertifikat klien akan dipilih secara otomatis dari konteks pengguna saat ini dari tempat Anda menjalankan perintah.

Contoh

Contoh berikut menunjukkan cara menentukan sertifikat komputer lokal yang memiliki thumbprint aa bb cc dd ee tanpa permintaan.

TfsConfig certificates /machine /thumbprint:aa bb cc dd ee /noprompt

Contoh berikut menunjukkan cara menentukan dengan menggunakan pilihan otomatis sertifikat klien dari penyimpanan pengguna saat ini.

TfsConfig certificates /autoselect

---

ChangeServerID

Perintah changeServerID mengubah GUID yang terkait dengan database untuk Azure DevOps Server. GUID harus unik dalam penyebaran Azure DevOps Server. Jika lebih dari satu database memiliki GUID yang sama, penyebaran Anda bisa menjadi tidak stabil atau tidak dapat digunakan. Anda dapat mengubah GUID untuk database konfigurasi, GUID untuk semua database pengumpulan proyek dalam penyebaran, atau keduanya.

Meskipun Anda biasanya tidak akan menggunakan perintah ini dalam operasi harian, Anda dapat menggunakan perintah ini dalam keadaan berikut:

• Anda memulihkan penyebaran ke perangkat keras baru, penyebaran lama masih beroperasi, dan Anda ingin menggunakan kedua penyebaran. Skenario ini terkadang disebut sebagai kloning server.

• Anda ingin menguji pembaruan perangkat lunak atau konfigurasi perangkat keras pada penyebaran duplikat sehingga Anda tidak berisiko mengganggu lingkungan produksi Anda.

• Anda ingin sepenuhnya menguji pemulihan database ke perangkat keras baru di lab pengujian atau lingkungan terpisah, untuk memastikan bahwa penyebaran Anda dapat dipulihkan.

• Anda harus mengatur ulang GUID untuk database koleksi setelah memindahkannya ke penyebaran lain yang GUID-nya sudah dicadangkan.

Catatan

Perintah changeServerID tidak dapat dibatalkan. Setelah GUID diubah, Anda tidak dapat membatalkan perubahan tersebut kecuali dengan memulihkan versi database tersebut sebelumnya.

TfsConfig changeServerID /sqlInstance:<serverName> /databaseName:<configurationDatabaseName>
	[/projectCollectionsOnly] [/configDBOnly] [/collectionName]

Opsi	Deskripsi
sqlInstance	Wajib diisi. Menentukan nama server yang menjalankan SQL Server dan nama instans jika Anda ingin menggunakan instans selain instans default. Jika Anda menentukan instans, Anda harus menggunakan format: ServerName\InstanceName.
databaseName	Wajib diisi. Menentukan nama database konfigurasi untuk Azure DevOps Server. Secara default, nama database ini TFS_ConfigurationDB.
projectCollectionsOnly	Menentukan bahwa hanya GUID untuk koleksi yang akan diubah.
configDBOnly	Menentukan bahwa hanya GUID untuk database konfigurasi yang akan diubah.
collectionName	Menentukan untuk membuat id instans baru untuk koleksi tertentu tetapi tidak untuk instans Azure DevOps dan koleksi lainnya.

Prasyarat

Untuk menggunakan perintah changeServerID, Anda harus menjadi anggota kelompok keamanan Administrator Azure DevOps dan anggota peran keamanan sysadmin untuk semua instans SQL Server yang Azure DevOps Server gunakan. Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server.

Keterangan

Anda menggunakan perintah changeServerID untuk membuat duplikat diskrit dari penyebaran Azure DevOps Server untuk tujuan pengujian atau kloning. Setelah Anda menggunakan perintah changeServerID, Anda harus mengarahkan klien untuk membuat koneksi ke server yang diubah sebelum dapat digunakan.

Contoh

Contoh berikut menunjukkan cara mengubah GUID semua database dalam penyebaran Contoso1 Azure DevOps Server, di mana database konfigurasi dihosting di server yang diberi nama ContosoMain pada instans bernama TeamDatabases di SQL Server.

TfsConfig changeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

---

CodeIndex

Gunakan perintah codeIndex untuk mengelola pengindeksan kode pada Azure DevOps Server. Misalnya, Anda mungkin ingin mengatur ulang indeks untuk memperbaiki informasi CodeLens, atau menonaktifkan pengindeksan untuk menyelidiki masalah performa server.

TfsConfig codeIndex /indexingStatus | /setIndexing:[on|off|keepupOnly] |
	/ignoreList:[ add | remove | removeAll | view ] <serverPath> |
	/listLargeFiles [/fileCount:FileCount] [/minSize:MinSize] |
	/reindexAll | 
    /destroyCodeIndex [/noPrompt] |
	/temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ] |
	/indexHistoryPeriod:[ view | all | <NumberOfMonths> ] [/collectionName:<collectionName> | /collectionId:<collectionId>]

Opsi	Deskripsi
indexingStatus	Menampilkan status dan konfigurasi layanan pengindeksan kode.
setIndexing	on: Mulai mengindeks semua changeset. off: Berhenti mengindeks semua changeset. keepupOnly: Berhenti mengindeks changeset yang dibuat sebelumnya dan mulai mengindeks hanya changeset baru.
ignoreList	Menentukan daftar file kode dan jalurnya yang tidak ingin Anda indeks. add: Menambahkan file yang tidak ingin Anda indeks ke daftar file yang diabaikan. remove: Menghapus file yang ingin Anda indeks dari daftar file yang diabaikan. removeAll: Menghapus daftar file yang diabaikan dan mulai mengindeks semua file. view: Melihat semua file yang tidak sedang diindeks. ServerPath: Menentukan jalur ke file kode. Anda dapat menggunakan wildcard (*) di awal, akhir, atau kedua ujung jalur server.
listLargeFiles	Memperlihatkan jumlah file yang ditentukan yang melebihi ukuran yang ditentukan dalam KB. Anda kemudian dapat menggunakan opsi /ignoreList untuk mengecualikan file-file ini dari pengindeksan. Untuk ini, Anda memerlukan Team Foundation Server 2013 dengan Update 3.
reindexAll	Menghapus data yang diindeks sebelumnya dan memulai ulang pengindeksan.
destroyCodeIndex	Menghapus indeks kode dan menghapus semua data terindeks. Tidak memerlukan konfirmasi jika Anda menggunakan opsi /noPrompt.
temporaryDataSizeLimit	Mengontrol berapa banyak data sementara yang dibuat CodeLens saat memproses changeset. Batas default adalah 6 GB (2 GB di Update 5). view: Menampilkan batas ukuran saat ini. SizeInGBs: Mengubah batas ukuran. disable: Menghapus batas ukuran. Batas ini diperiksa sebelum CodeLens memproses changeset baru. Jika data sementara melebihi batas ini, CodeLens akan menjeda pemrosesan changeset sebelumnya, bukan yang baru. CodeLens akan memulai ulang pemrosesan setelah data dibersihkan dan berada di bawah batas ini. Pembersihan berjalan secara otomatis sekali sehari. Ini berarti data sementara dapat melebihi batas ini sampai pembersihan mulai berjalan. Untuk ini, Anda memerlukan Team Foundation Server 2013 dengan Update 4.
indexHistoryPeriod	Mengontrol berapa lama untuk mengindeks riwayat perubahan Anda. Ini memengaruhi berapa banyak riwayat yang ditunjukkan CodeLens kepada Anda. Batas defaultnya adalah 12 bulan. Ini berarti CodeLens hanya menunjukkan riwayat perubahan Anda dari 12 bulan terakhir. view: Menampilkan jumlah bulan saat ini. all: Indeks semua riwayat perubahan. NumberOfMonths: Mengubah jumlah bulan yang digunakan untuk mengindeks riwayat perubahan. Untuk ini, Anda memerlukan Team Foundation Server 2013 dengan Update 4.
collectionName	Menentukan nama kumpulan proyek untuk menjalankan perintah CodeIndex. Diperlukan jika Anda tidak menggunakan /CollectionId.
collectionId	Menentukan nomor identifikasi kumpulan proyek untuk menjalankan perintah CodeIndex. Diperlukan jika Anda tidak menggunakan /CollectionName

Prasyarat

Untuk menggunakan perintah codeIndex, Anda harus menjadi anggota kelompok keamanan Administrator Azure DevOps. Lihat Referensi izin untuk Azure DevOps Server.

Contoh

Untuk melihat status dan konfigurasi pengindeksan kode:

TfsConfig codeIndex /indexingStatus /collectionName:"Fabrikam Web Site"

Untuk mulai mengindeks semua changeset:

TfsConfig codeIndex /setIndexing:on /collectionName:"Fabrikam Web Site"

Untuk berhenti mengindeks changeset yang dibuat sebelumnya dan mulai mengindeks hanya changeset baru:

TfsConfig codeIndex /setIndexing:keepupOnly /collectionName:"Fabrikam Web Site"

Untuk menemukan hingga 50 file yang lebih besar dari 10 KB:

TfsConfig codeIndex /listLargeFiles /fileCount:50 /minSize:10 /collectionName:"Fabrikam Web Site"

Untuk mengecualikan file tertentu dari pengindeksan dan menambahkannya ke daftar file yang diabaikan:

TfsConfig codeIndex /ignoreList:add "$/Fabrikam Web Site/Catalog.cs" /collectionName:"Fabrikam Web Site"

Untuk melihat semua file yang tidak diindeks:

TfsConfig codeIndex /ignoreList:view

Untuk menghapus data yang diindeks sebelumnya dan memulai ulang pengindeksan:

TfsConfig codeIndex /reindexAll /collectionName:"Fabrikam Web Site"

Untuk menyimpan semua riwayat changeset:

TfsConfig codeIndex /indexHistoryPeriod:all /collectionName:"Fabrikam Web Site"

Untuk menghapus batas ukuran pada data sementara CodeLens dan melanjutkan pengindeksan terlepas dari ukuran data sementara:

TfsConfig codeIndex /temporaryDataSizeLimit:disable /collectionName:"Fabrikam Web Site"

Untuk menghapus indeks kode dengan konfirmasi:

TfsConfig codeIndex /destroyCodeIndex /collectionName:"Fabrikam Web Site"

---

Koleksi

Anda dapat menggunakan perintah koleksi untuk melampirkan, mencopot, atau menghapus koleksi proyek dari penyebaran Azure DevOps Server. Anda juga dapat menggunakan perintah koleksi untuk menduplikasi database koleksi yang ada, mengganti namanya, dan melampirkannya ke penyebaran. Proses ini terkadang disebut sebagai kloning koleksi.

TfsConfig collection {/attach | /create | /detach | /delete} [/collectionName:<collectionName>]
    [/description:<collectionDescription>]
    [/collectionDB:<serverName>;<databaseName>]
    [/processModel:Inheritance|Xml]
    [/reportingFolder:<reportingFolderPath>]
    [/clone] [/verify] [/continue]

Opsi	Deskripsi
attach	Diperlukan jika tidak ada /detach atau /delete yang digunakan. Jika Anda menentukan opsi ini, Anda juga harus menggunakan opsi /collectionDB. Sebagai opsi, Anda juga dapat menggunakan /collectionName dan /clone dengan opsi ini. Jika Anda menggunakan opsi /attach, database koleksi yang ditentukan akan ditambahkan ke penyebaran Azure DevOps Server Anda.
buat	Membuat koleksi.
detach	Diperlukan jika tidak ada /attach atau /delete yang digunakan. Jika Anda menentukan opsi ini, Anda juga harus menggunakan opsi /collectionName. Jika Anda menggunakan opsi /detach, database untuk koleksi yang ditentukan akan dihentikan, dan koleksi akan terlepas dari penyebaran Azure DevOps Server Anda.
hapus	Diperlukan jika tidak ada /detach atau /attach yang digunakan. Jika Anda menentukan opsi ini, Anda juga harus menggunakan opsi /collectionName. Jika Anda menggunakan opsi /delete, database untuk koleksi yang ditentukan akan dihentikan, dan koleksi akan terlepas secara permanen dari penyebaran Azure DevOps Server Anda. Anda tidak akan dapat melampirkan ulang database koleksi ke penyebaran ini atau penyebaran lainnya.
CollectionName	Menentukan nama koleksi proyek. Jika nama koleksi berisi spasi, Anda harus mengapit nama dalam tanda kutip (misalnya, "Koleksi Saya"). Diperlukan jika /detach atau /delete digunakan. Jika Anda menggunakan opsi ini dengan /detach atau /delete, opsi ini menentukan koleksi yang akan dilepas atau dihapus. Jika Anda menggunakan opsi ini dengan /attach, opsi ini menentukan nama baru untuk koleksi. Jika Anda menggunakan opsi ini dengan /attach dan /clone, opsi ini menentukan nama untuk koleksi duplikat.
CollectionDB	Diperlukan jika /attach digunakan. Opsi ini menentukan nama server yang menjalankan SQL Server dan nama database koleksi yang dihosting di server tersebut.
ServerName	Menentukan nama server yang menghosting database konfigurasi untuk Azure DevOps Server, dan nama instans jika Anda ingin menggunakan instans selain instans default. Jika Anda menentukan instans, Anda harus menggunakan format: ServerName\InstanceName.
DatabaseName	Menentukan nama database konfigurasi. Secara default, nama database ini TFS_ConfigurationDB.
klon	Jika Anda menentukan opsi ini, database koleksi asli akan dilampirkan sebagai kloning di SQL Server, dan database ini akan dilampirkan ke Azure DevOps Server. Opsi ini terutama digunakan sebagai bagian dari pemisahan koleksi proyek.

Tip

Opsi /delete tidak akan menghapus database koleksi dari SQL Server. Setelah menghapus database koleksi dari Azure DevOps Server, Anda bisa menghapus database secara manual dari SQL Server.

Prasyarat

Untuk menggunakan perintah koleksi, Anda harus menjadi anggota kelompok keamanan Administrator Team Foundation serta grup Administrator lokal pada komputer yang menjalankan TfsConfig. Anda juga harus menjadi anggota peran keamanan sysadmin untuk semua instans SQL Server yang digunakan oleh database Azure DevOps Server. Jika penyebaran Anda terintegrasi dengan SharePoint dan Anda menggunakan opsi /delete, Anda juga harus menjadi anggota grup Administrator Farm untuk farm SharePoint tempat Anda menghapus kumpulan situs.

Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server.

Keterangan

Untuk mengelola koleksi secara interaktif atau membuat koleksi, Anda dapat menggunakan simpul Koleksi Proyek di konsol administrasi untuk Azure DevOps. Lihat Mengelola koleksi proyek.

Contoh

Contoh berikut menunjukkan cara menghapus Contoso Summer Intern Projects koleksi proyek secara permanen dari penyebaran Azure DevOps Server.

TfsConfig collection /delete /CollectionName:"Contoso Summer Intern Projects"

TFSConfig - Team Foundation Server Configuration Tool
Copyright � Microsoft Corporation. All rights reserved.
Deleting a project collection is an irreversible operation. A deleted collection cannot be reattached to the same or another Team Foundation Server. Are you sure you want to delete 'Contoso Summer Intern Projects'? (Yes/No)
Yes
Found Collection 'Contoso Summer Intern Projects' Deleting...
The delete of collection 'Contoso Summer Intern Projects' succeeded.

Contoh berikut menunjukkan cara menduplikasi Contoso Summer Interns Projects koleksi proyek, menamainya Contoso Winter Interns Projects, dan melampirkan koleksi duplikat ke penyebaran Azure DevOps Server.

TfsConfig collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects"
    /CollectionName:"Contoso Winter Intern Projects" /clone

---

ColumnStoreIndex

Catatan

Ketersediaan perintah: Memerlukan TFS 2015.2 dan versi yang lebih baru.

Anda menggunakan perintah columnStoreIndex untuk mengaktifkan atau menonaktifkan indeks penyimpanan kolom untuk database yang digunakan oleh penyebaran Azure DevOps Server Anda.

TfsConfig columnStoreIndex /enabled:<true|false>
	/sqlInstance:<serverName>
	/databaseName:<databaseName>

Opsi	Deskripsi
diaktifkan	Menentukan apakah Anda mengaktifkan atau menonaktifkan indeks penyimpanan kolom untuk instans dan database SQL yang diberikan.
sqlInstance	Menentukan nama server yang menghosting database tempat indeks penyimpanan kolom diaktifkan atau dinonaktifkan, dan nama instans jika instans selain default digunakan. Jika Anda menentukan instans, Anda harus menggunakan format: ServerName\InstanceName.
databaseName	Menentukan nama database tempat indeks penyimpanan kolom diaktifkan atau dinonaktifkan.

Prasyarat

Untuk menggunakan perintah columnStoreIndex, Anda harus menjadi anggota peran sysadmin untuk instans SQL Server yang ditentukan.

Keterangan

Anda biasanya akan menggunakan perintah columnStoreIndex jika Anda memindahkan database dari instans SQL yang mendukung indeks penyimpanan kolom ke yang tidak. Dalam hal ini, Anda harus menonaktifkan semua indeks penyimpanan kolom sebelum berhasil memindahkan database. Demikian pula, jika Anda memindahkan database kembali ke instans SQL yang mendukung indeks penyimpanan kolom, Anda mungkin ingin mengaktifkan kembali indeks penyimpanan kolom untuk menghemat ruang dan mendapatkan performa.

Contoh

Contoh berikut menunjukkan cara mengaktifkan indeks penyimpanan kolom, untuk database bernama TFS_DefaultCollection pada instans SQL yang berjalan di server bernama ContosoMain pada instans bernama TeamDatabases.

TfsConfig columnStoreIndex /enabled:true /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection

---

ConfigureMail

Mengonfigurasi server yang menjalankan Azure DevOps Server untuk menggunakan server SMTP yang ada untuk pemberitahuan email.

TfsConfig configureMail /Enabled:<true|false> /FromEmailAddress:<emailAddress> /SmtpHost:<SMTPHostName>

Opsi	Deskripsi
FromEmailAddress	Menentukan alamat tempat mengirim pemberitahuan email dari Azure DevOps Server untuk cek masuk, item kerja yang ditetapkan untuk Anda, atau pemberitahuan lainnya. Alamat ini juga diperiksa validitasnya dan, tergantung pada konfigurasi server Anda, mungkin harus mewakili akun email yang valid di server email. Jika alamat tidak ada atau tidak valid, alamat email default akan digunakan.
SmtpHost	Menentukan nama server yang menghosting server email.

Prasyarat

Untuk menggunakan perintah configureMail, Anda harus menjadi anggota kelompok keamanan Administrator Team Foundation di server tingkat aplikasi Azure DevOps. Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server

Keterangan

Anda juga dapat menggunakan konsol administrasi untuk mengonfigurasi Azure DevOps Server untuk menggunakan server SMTP.

Contoh

Contoh berikut menunjukkan sintaks yang digunakan untuk mengonfigurasi dari alamat email ke TFS@contoso.com dan server email SMTP sebagai ContosoMailServer:

TfsConfig configureMail /FromEmailAddress:TFS@contoso.com /SmtpHost:ContosoMailServer

---

DBCompression

Anda menggunakan perintah dbCompression untuk mengaktifkan atau menonaktifkan pemadatan halaman database untuk database yang digunakan oleh penyebaran Azure DevOps Server Anda.

TfsConfig dbCompression /pageCompression:[enable|disable]
	/sqlInstance:<serverName>
	/databaseName:<databaseName>
	[/rebuildNow [/offline]]

Opsi	Deskripsi
pageCompression	Menentukan apakah Anda mengaktifkan atau menonaktifkan pemadatan halaman untuk instans dan database SQL yang diberikan.
sqlInstance	Menentukan nama server yang menghosting database tempat indeks penyimpanan kolom diaktifkan atau dinonaktifkan, dan nama instans jika instans selain default digunakan. Jika Anda menentukan instans, Anda harus menggunakan format: ServerName\InstanceName
databaseName	Menentukan nama database tempat pemadatan halaman diaktifkan atau dinonaktifkan.
rebuildNow	Opsional. Menentukan apakah indeks database harus dibangun kembali (dan dikompresi atau didekompresi seperlunya) segera. Jika tidak digunakan, indeks akan dibangun kembali oleh pekerjaan latar belakang yang berjalan setiap minggu.
offline	Opsional. Hanya digunakan dalam kombinasi dengan /rebuildNow. Jika /offline tidak ditentukan, indeks akan dibangun kembali secara online. Jika /offline ditentukan, indeks akan dibangun kembali secara offline. Ini akan memblokir operasi lain, tetapi mungkin lebih cepat daripada membangun kembali indeks online.

Prasyarat

Untuk menggunakan perintah dbCompression, Anda harus menjadi anggota peran sysadmin untuk instans SQL Server yang ditentukan.

Keterangan

Anda biasanya akan menggunakan perintah dbCompression jika Anda memindahkan database dari instans SQL yang mendukung pemadatan ke yang tidak. Dalam hal ini, Anda harus menonaktifkan semua pemadatan dan mendekompresi semua indeks sebelum berhasil memindahkan database. Demikian pula, jika Anda memindahkan database kembali ke instans SQL yang mendukung pemadatan, Anda mungkin ingin mengaktifkan kembali pemadatan untuk menghemat ruang.

Perintah ini hanya mengubah apakah Azure DevOps Server lebih suka menggunakan pemadatan halaman database atau tidak - database Anda masih harus dihosting dalam instans SQL yang edisinya mendukung pemadatan. Lihat Fitur yang Didukung oleh Edisi SQL Server untuk informasi selengkapnya.

Contoh

Contoh berikut menunjukkan cara mengaktifkan pemadatan halaman dengan segera, dengan indeks dibangun kembali secara online, untuk database yang dinamai TFS_DefaultCollection pada instans SQL yang berjalan di server bernama ContosoMain pada instans bernama TeamDatabases.

TfsConfig dbCompression /pageCompression:enable /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /rebuildNow

---

DeleteTestResults

Anda menggunakan perintah deleteTestResults untuk menghapus hasil pengujian lama yang disimpan dari penyimpanan koleksi Anda. Ini biasanya dilakukan untuk mengurangi ukuran penyimpanan atau untuk mengurangi waktu yang diperlukan saat memigrasikan hasil pengujian ke skema baru.

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]

Opsi	Deskripsi
ageInDays	Hasil pengujian yang lebih lama dari jumlah hari yang ditentukan akan dihapus atau dipratinjau.
sqlInstance	Nama server yang menghosting database yang hasil pengujiannya sedang dihapus atau dipratinjau, dan nama instans jika instans selain default digunakan. Jika Anda menentukan instans, Anda harus menggunakan format: ServerName\InstanceName.
databaseName	Nama database yang hasil pengujiannya sedang dihapus atau dipratinjau.
jenis	Opsional. Jenis hasil pengujian yang akan dihapus. Nilai yang valid adalah otomatis, manual, dan semua.
pratinjau	Opsional. Tampilkan jumlah hasil pengujian yang akan dihapus berdasarkan usia dalam hari, tetapi jangan hapus hasil ini.

Prasyarat

Untuk menggunakan perintah deleteTestResults, Anda harus menjadi anggota peran sysadmin untuk instans SQL Server yang ditentukan.

Keterangan

Gunakan parameter /preview untuk melihat hasil pengujian yang diurutkan menurut nama proyek dan tahun tanpa menghapus hasil ini.

Contoh

Contoh berikut menunjukkan cara menghapus hasil pengujian manual yang lebih lama dari 60 hari untuk database bernama TFS_DefaultCollection pada instans SQL yang berjalan di server bernama ContosoMain pada instans bernama TeamDatabases.

TfsConfig deleteTestResults /ageInDays:60 /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /type:manual

---

DeploymentPool

Perintah deploymentPool dirancang untuk memigrasikan semua grup penyebaran dari satu kumpulan penyebaran ke kumpulan penyebaran lainnya.

TfsConfig deploymentpool /migrateDeploymentGroups /fromPool:<source pool name> /toPool:<destination pool name>

Opsi	Deskripsi
fromPool	Nama kumpulan sumber.
toPool	Nama kumpulan tujuan.

---

Identities

Perintah identitas mencantumkan atau mengubah pengidentifikasi keamanan (SID) pengguna dan grup dalam penyebaran Azure DevOps Server Anda. Anda mungkin perlu mengubah atau memperbarui SID untuk pengguna dan grup dalam salah satu skenario berikut:

• Mengubah domain penyebaran Anda

• Mengubah dari grup kerja ke domain atau dari domain ke grup kerja

• Memigrasikan akun di seluruh domain di Direktori Aktif

Catatan

Anda tidak perlu menjalankan perintah ini jika Anda mengubah domain dalam forest Direktori Aktif yang sama. Azure DevOps Server akan secara otomatis menangani perubahan SID untuk perpindahan di dalam forest yang sama.

TfsConfig identities [/change /fromdomain:<domainName1> /todomain:<domainName2>
    [/account:<accountName> [/toaccount:<accountName>]] [/sqlInstance:<serverName> /databaseName:<databaseName>]

Opsi	Deskripsi
ubah	Menentukan bahwa Anda ingin mengubah identitas alih-alih mencantumkannya.
fromdomain	Diperlukan saat menggunakan /change. Menentukan domain asli identitas yang ingin Anda ubah. Jika Anda mengubah dari lingkungan grup kerja, tentukan nama komputer.
todomain	Diperlukan saat menggunakan /change. Menentukan domain yang ingin Anda ubah identitasnya. Jika Anda mengubah dari lingkungan grup kerja, tentukan nama komputer.
akun	Menentukan nama akun yang ingin Anda daftarkan atau ubah identitasnya.
toaccount	Menentukan nama akun yang ingin Anda daftarkan atau ubah identitasnya.
SQLInstance	Menentukan nama server yang menjalankan SQL Server dan nama instans jika Anda ingin menggunakan instans selain instans default. Jika Anda menentukan instans, Anda harus menggunakan format berikut: ServerName\InstanceName
DatabaseName	Menentukan nama database konfigurasi untuk Azure DevOps Server.

Prasyarat

Untuk menggunakan perintah identitas, Anda harus menjadi anggota kelompok keamanan Administrator Team Foundation dan anggota peran keamanan sysadmin untuk semua instans SQL Server yang Team Foundation Server gunakan. Untuk informasi selengkapnya, lihat Mengatur izin administrator untuk Azure DevOps Server.

Keterangan

Anda dapat secara opsional menentukan database untuk mengubah identitas sebelum mengonfigurasi server tingkat aplikasi untuk penyebaran. Misalnya, Anda dapat menentukan database untuk mengubah akun layanan saat mengkloning penyebaran Azure DevOps Server.

Saat Anda mengubah identitas, akun atau akun target harus sudah ada di Windows.

Anda harus menunggu sinkronisasi identitas berikutnya dengan Windows sebelum properti akun yang Anda ubah dengan perintah ini akan diperbarui. Persyaratan ini mencakup perubahan dari grup ke pengguna, pengguna ke grup, dan akun domain ke akun lokal.

Contoh

Contoh berikut menunjukkan cara mencantumkan nama semua pengguna dan grup Windows yang disimpan di Azure DevOps Server dan menampilkan apakah SID untuk setiap pengguna atau grup cocok dengan SID di Windows. Administrator domain Contoso1 membuat grup domain seperti Contoso1\\Developers dan Contoso1\\Testers untuk membantu memudahkan pengelolaan izin di Azure DevOps Server, SQL Server Reporting Services, dan produk SharePoint.

TfsConfig identities

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.

    Account Name Exists (see note 1) Matches (see note 2)
    --------------------------------------------------------------------
    CREATOR OWNER True True
    Contoso1\hholt True True
    BUILTIN\Administrators True True
    Contoso1\Developers True True
    Contoso1\Testers True True
    Contoso1\PMs True True
    Contoso1\jpeoples True True
    Contoso1\Domain Admins True True
    Contoso1\SVCACCT1 True True

    9 security identifiers (SIDs) were found stored in Team Foundation Server. Of these, 9 were found in Windows. 0 had differing SIDs.

Contoh berikut menunjukkan cara mengubah SID untuk semua akun di Azure DevOps Server dari domain Contoso1 ke SID untuk akun yang memiliki nama yang cocok di ContosoPrime domain. Hanya nama akun yang cocok yang akan memperbarui SID-nya. Misalnya, jika hholt akun ada sebagai Contoso1\hholt dan ContosoPrime\hholt, SID akun akan diubah ke SID untuk ContosoPrime\hholt. Jika ContosoPrime\hholt akun tidak ada, SID tidak akan diperbarui untuk Contoso1\hholt.

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime

Contoh berikut menunjukkan cara mengubah akun untuk satu akun pengguna, Contoso1\hholt, ke akun untuk akun pengguna lain, ContosoPrime\jpeoples.

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples

Contoh berikut menunjukkan cara mengubah SID NT AUTHORITY\NETWORK SERVICE akun layanan yang digunakan dalam penyebaran Azure DevOps Server saat mengubah domain penyebaran dari Contoso1 ke ContosoPrime. Untuk mengubah akun sistem seperti Layanan Jaringan, Anda harus mengikuti proses dua tahap. Anda terlebih dahulu mengubah akun layanan dari NT AUTHORITY\NETWORK SERVICE ke akun domain di domain TempSVC baru, lalu Anda mengubah akun kembali ke LAYANAN JARINGAN di server di domain baru. Database konfigurasi dihosting di server yang diberi nama ContosoMain pada instans TeamDatabases bernama di SQL Server.

TfsConfig identities /change /fromdomain:"NT AUTHORITY" /todomain:ContosoPrime /account:"NETWORK SERVICE"
  /toaccount:TempSVC /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

TfsConfig identities /change /fromdomain:ContosoPrime /todomain:"NT AUTHORITY" /account:TempSVC
	/toaccount:"NETWORK SERVICE"

---

Pekerjaan

Anda dapat menggunakan perintah pekerjaan untuk membuat file log yang menyediakan detail aktivitas pekerjaan terbaru untuk koleksi proyek tertentu, atau mencoba kembali pekerjaan untuk satu atau semua koleksi proyek.

TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]

Opsi	Deskripsi
coba lagi	Diperlukan jika /dumplog tidak digunakan. Menentukan bahwa pekerjaan terbaru akan dicoba ulang untuk koleksi proyek yang ditentukan. Jika Anda menggunakan opsi ini, Anda juga harus menggunakan opsi/CollectionName atau /CollectionID.
dumplog	Diperlukan jika /retry tidak digunakan. Menentukan bahwa aktivitas pekerjaan terbaru untuk koleksi akan dikirim ke file log. Jika Anda menggunakan opsi ini, Anda juga harus menggunakan opsi/CollectionName atau /CollectionID.
CollectionName	Diperlukan jika /CollectionID tidak digunakan. Menentukan nama koleksi yang pekerjaan terbarunya akan dicoba ulang (/retry) atau dicatat (/dumplog). Jika Anda ingin menentukan semua koleksi, Anda dapat menggunakan tanda bintang (*).
CollectionID	Diperlukan jika /CollectionName tidak digunakan. Menentukan nomor identifikasi koleksi yang pekerjaan terbarunya akan dicoba ulang (/retry) atau dicatat (/dumplog).

Prasyarat

Untuk menggunakan perintah pekerjaan, Anda harus menjadi anggota kelompok keamanan Administrator Azure DevOps. Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server.

Keterangan

Untuk mencoba kembali pekerjaan secara interaktif, Anda dapat membuka konsol administrasi untuk Azure DevOps, pilih tab Status untuk koleksi, lalu pilih Coba Lagi Pekerjaan. Untuk informasi selengkapnya, lihat Membuka Konsol Administrasi Azure DevOps Server.

Contoh

Contoh berikut menunjukkan cara membuat file log yang mencantumkan aktivitas pekerjaan terbaru untuk Contoso Summer Intern Projects koleksi proyek di Azure DevOps Server.

TfsConfig jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"

---

OfflineDetach

Anda menggunakan perintah offlineDetach untuk membuat database koleksi offline ke dalam database koleksi offline yang dicopot.

TfsConfig offlineDetach /configurationDB:<databaseName>
    /collectionDB:<databaseName>

Opsi	Deskripsi
configurationDB	Menentukan nama database konfigurasi yang akan digunakan.
collectionDB	Menentukan nama database koleksi yang akan dicopot.

Prasyarat

Untuk menggunakan perintah offlineDetach, Anda harus menjadi anggota peran sysadmin untuk instans SQL Server yang ditentukan.

Keterangan

Perintah ini memodifikasi skema database koleksi yang ditentukan dan tidak boleh dijalankan terhadap database yang digunakan oleh penyebaran Team Foundation Server. Jika database Anda digunakan oleh penyebaran Team Foundation Server, gunakan TfsConfig collection /detach sebagai gantinya.

Perintah ini berguna ketika Anda perlu memulihkan database koleksi individual dari cadangan tanpa memulihkan database koleksi lain yang merupakan bagian dari penyebaran Azure DevOps Server yang sama. Sebelumnya ini diperlukan untuk memulihkan sekumpulan database yang lengkap dan konsisten (konfigurasi dan semua koleksi) ke lingkungan penahapan, mengonfigurasi penyebaran Azure DevOps Server menggunakan database tersebut, dan melepaskan satu koleksi yang menarik.

Sebagai gantinya, Anda sekarang dapat memulihkan salinan database konfigurasi yang konsisten dan database koleksi yang diminati dan menjalankan perintah offlineDetach. Database koleksi yang dicopot kemudian dapat dilampirkan ke penyebaran Azure DevOps Server apa pun pada versi yang sesuai.

Contoh

Contoh berikut mengilustrasikan pencopotan database koleksi bernama TFS_PrimaryCollection, menggunakan database konfigurasi bernama TFS_Configuration, dengan keduanya pada instans SQL yang berjalan di server bernama ContosoTemp pada instans bernama Backups.

TfsConfig offlineDetach /configurationDB:ContosoTemp\Backups;TFS_Configuration /collectionDB:ContosoTemp\Backups;TFS_PrimaryCollection

---

Proksi

Anda dapat menggunakan perintah proksi untuk memperbarui atau mengubah pengaturan yang digunakan oleh Azure DevOps Proxy Server. Azure DevOps Proxy Server menyediakan dukungan bagi tim terdistribusi untuk menggunakan kontrol versi dengan mengelola cache file kontrol versi yang diunduh di lokasi tim terdistribusi. Dengan mengonfigurasi Azure DevOps Proxy Server, Anda dapat secara signifikan mengurangi bandwidth yang diperlukan di koneksi area yang luas. Selain itu, Anda tidak perlu mengelola pengunduhan dan penembolokan file versi; manajemen file transparan bagi pengembang yang menggunakan file. Sementara itu, setiap pertukaran metadata dan unggahan file terus muncul di Azure DevOps Server. Jika Anda menggunakan layanan Azure DevOps untuk menghosting proyek pengembangan Anda di cloud, Anda dapat menggunakan perintah Proksi untuk tidak hanya mengelola cache untuk proyek dalam koleksi yang dihosting, tetapi juga untuk mengelola beberapa pengaturan yang digunakan oleh layanan tersebut.

Untuk informasi selengkapnya tentang menginstal Azure DevOps Proxy Server dan konfigurasi awal proksi,

Lihat Bagaimana cara: menginstal Azure DevOps Proxy Server dan mengatur situs jarak jauh. Untuk informasi selengkapnya tentang mengonfigurasi proksi di komputer klien, lihat Referensi Perintah Kontrol Versi Azure DevOps.

TfsConfig proxy /add|delete|change [/Collection:<teamProjectCollectionURL> /account:<accountName>]
	/Server:<TeamFoundationServerURL> [/inputs:Key1=Value1; Key2=Value2;...] [/continue]

Opsi	Deskripsi
$add	Menambahkan server atau koleksi yang ditentukan ke daftar proksi dalam file Proxy.config. Anda dapat menjalankan /add beberapa kali untuk menyertakan lebih banyak koleksi atau server. Saat menggunakan /add dengan koleksi yang dihosting di Azure DevOps Services, Anda akan dimintai kredensial Anda di Azure DevOps Services.
ubah	Mengubah kredensial yang disimpan sebagai akun layanan untuk Azure DevOps Services. Opsi /change hanya digunakan untuk Azure DevOps Services; opsi ini tidak boleh digunakan untuk penyebaran lokal Azure DevOps Server.
hapus	Menghapus server atau koleksi yang ditentukan dari daftar proksi dalam file Proxy.config.
akun	Menentukan akun yang digunakan sebagai akun layanan untuk proksi di Azure DevOps Services. Opsi ini hanya digunakan untuk Azure DevOps Services bersama dengan opsi /change. Akun layanan default yang digunakan untuk Azure DevOps Services adalah "Layanan Akun."
lanjutkan	Melanjutkan eksekusi perintah bahkan jika proses verifikasi menghasilkan peringatan.
Koleksi	Menentukan URL koleksi proyek yang dihosting di Azure DevOps Services, dalam AccountName.DomainName/CollectionName format.
akun	Menentukan nama akun yang digunakan sebagai akun layanan untuk Azure DevOps Services. Jika nama akun memiliki spasi, nama harus diapit dalam tanda kutip (""). Semua karakter khusus dalam nama akun harus ditentukan sesuai dengan sintaks baris perintah.
akun	Menentukan URL penyebaran Azure DevOps Server, dalam ServerURL:Port/tfs format.
PersonalAccessTokenFile	Secara opsional menentukan jalur ke file yang berisi token akses pribadi. Token ini akan digunakan untuk mengautentikasi ke koleksi atau akun saat mendaftarkan proksi. (Ditambahkan dalam TFS 2018 Update 1)
inputs	Opsional. Menentukan pengaturan dan nilai tambahan yang akan digunakan saat mengonfigurasi proksi.! Misalnya, nilai untuk GvfsProjectName dan GvfsRepositoryName dapat digunakan untuk mengonfigurasi repositori Git untuk digunakan dengan Git Virtual File System (GVFS) (Ditambahkan dalam TFS 2018 Update 1)

Prasyarat

Untuk menggunakan perintah proksi, Anda harus menjadi anggota kelompok keamanan Administrator Azure DevOps dan administrator di server proksi. Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server.

Keterangan

Anda menggunakan perintah proksi untuk memperbarui konfigurasi Azure DevOps Server Proxy yang ada. Anda tidak dapat menggunakan perintah proksi untuk penginstalan awal dan konfigurasi proksi.

Contoh

Contoh berikut menunjukkan cara menambahkan penyebaran Azure DevOps Server bernama FABRIKAM ke daftar proksi.

TfsConfig proxy /add /Server:http://www.fabrikam.com:8080/tfs 

Contoh berikut menunjukkan cara menambahkan koleksi proyek yang dihosting di layanan Azure DevOps ke daftar proksi menggunakan Token Akses Pribadi untuk mengautentikasi. Token ini hanya akan digunakan untuk mendaftarkan proksi dengan akun Azure DevOps Services - akun layanan default masih akan digunakan untuk menjalankan proksi. Parameter ini ditambahkan dalam TFS 2018 Update 1 untuk mendukung pendaftaran Proxy dengan Azure DevOps Services tanpa memerlukan permintaan masuk.

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver

Contoh berikut menunjukkan cara menambahkan koleksi proyek ke daftar proksi. Contoh ini menggunakan token akses pribadi untuk mengautentikasi terhadap koleksi yang ditentukan dengan /Collection parameter. Token akses pribadi yang akan digunakan disimpan ke file di c:\PersonalAccessToken.txt.

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
	/PersonalAccessTokenFile:c:\PersonalAccessToken.txt

Contoh berikut menunjukkan cara mengubah akun layanan yang digunakan oleh proksi untuk koleksi proyek yang dihosting di Azure DevOps Services. Koleksi diberi nama PhoneSaver, nama akun yang digunakan untuk Azure DevOps Services adalah HelenaPetersen.fabrikam.com, dan akun layanan yang digunakan oleh proksi diubah menjadi My Proxy Service Account. Karena nama akun berisi spasi, tanda kutip digunakan untuk mengapit nama.

TfsConfig proxy /change /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
	/account:"My Proxy Service Account"

Contoh berikut menunjukkan cara menambahkan repositori Git untuk digunakan dengan GVFS.

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver /inputs:GvfsProjectName=PhoneSaver;GvfsRepositoryName=AnotherRepository

---

RebuildWarehouse

Anda dapat menggunakan perintah rebuildWarehouse untuk membangun kembali database SQL Server Reporting Services dan SQL Server Analysis Services yang digunakan Azure DevOps Server.

TfsConfig rebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]

Opsi	Deskripsi
analysisServices	Diperlukan jika /all tidak digunakan. Menentukan bahwa hanya database untuk Analysis Services yang akan dibangun kembali. Jika tidak ada database untuk Analysis Services, Anda juga harus menggunakan opsi /reportingDataSourcePassword.
semua	Diperlukan jika /analysisServices tidak digunakan. Menentukan bahwa semua database pelaporan dan analisis yang Azure DevOps Server gunakan akan dibangun kembali.
reportingDataSourcePassword	Diperlukan jika database TFS_Analysis tidak ada. Menentukan kata sandi akun yang digunakan sebagai akun sumber data untuk SQL Server Reporting Services (TFSReports). Untuk informasi selengkapnya, lihat Akun layanan dan dependensi di Azure DevOps Server.

Prasyarat

Untuk menggunakan perintah rebuildWarehouse, Anda harus menjadi anggota grup berikut:

• Kelompok keamanan Administrator Azure DevOps dan kelompok keamanan Administrator di server atau server-server yang menjalankan konsol administrasi untuk Azure DevOps

• Grup sysadmin di server atau server-server yang menjalankan instans SQL Server yang menghosting database untuk Azure DevOps Server

Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server.

Keterangan

Anda dapat menggunakan perintah ini saat memindahkan atau memisahkan koleksi proyek, memulihkan data, atau mengubah konfigurasi penyebaran Anda.

Untuk memulai pembangunan kembali database ini secara interaktif, Anda dapat menggunakan simpul Pelaporan di konsol administrasi untuk Azure DevOps. Untuk informasi selengkapnya, lihat Membuka Konsol Administrasi Azure DevOps Server.

Contoh

Contoh berikut menunjukkan cara membangun kembali database Analysis Services untuk penyebaran Azure DevOps Server.

TfsConfig rebuildWarehouse /analysisServices

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.
    The Analysis Services database was successfully rebuilt.

---

RegisterDB

Gunakan registerDB untuk memperbarui nama server yang menghosting database konfigurasi di Azure DevOps Server. Anda mungkin menggunakan perintah ini saat memulihkan database konfigurasi ke perangkat keras baru atau saat mengubah domain penyebaran.

TfsConfig registerDB /sqlInstance:<serverName> /databaseName:<databaseName>

Opsi	Deskripsi
SQLInstance	Wajib diisi. Menentukan nama server yang menjalankan SQL Server dan nama instans jika Anda ingin menggunakan instans selain instans default. Jika Anda menentukan instans, Anda harus menggunakan format: ServerName\InstanceName.
databaseName	Wajib diisi. Menentukan nama database konfigurasi. Secara default, ini adalah Tfs_Configuration.

Prasyarat

Untuk menggunakan perintah registerDB, Anda harus menjadi anggota grup Administrator Azure DevOps di server tingkat aplikasi untuk Azure DevOps dan anggota grup sysadmin di SQL Server di server tingkat data untuk Azure DevOps. Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server.

Keterangan

Cadangkan database untuk Azure DevOps Server sebelum Anda menggunakan perintah ini.

Agar perintah registerDB berhasil, kumpulan aplikasi dan program berikut harus berjalan:

• Azure DevOps Server Application Pool (kumpulan aplikasi)
• ReportServer (kumpulan aplikasi)
• SQL Server Reporting Services (program)

Anda harus memberikan nama atau alamat yang tepat dari database konfigurasi agar perintah ini beroperasi dengan benar. Jika Anda harus mengubah server tempat database ini disimpan, Anda harus memastikan bahwa Azure DevOps Server menunjuk ke lokasi baru.

Contoh

Contoh berikut mengalihkan Azure DevOps Server ke database konfigurasi yang terletak di server ContosoMain dalam instans SQL Server TeamDatabases.

TfsConfig registerDB /SQLInstance:ContosoMain\TeamDatabases /databaseName:Tfs_Configuration

---

RemapDBs

Perintah remapDBs mengalihkan Azure DevOps Server ke databasenya ketika disimpan di lebih dari satu server dan Anda memulihkan, memindahkan, atau mengubah konfigurasi penyebaran Anda. Misalnya, Anda harus mengalihkan Azure DevOps Server ke database untuk koleksi proyek apa pun apabila Azure DevOps Server dihosting di server terpisah atau di server dari database konfigurasi. Anda juga harus mengalihkan Azure DevOps Server ke server atau server-server yang menjalankan SQL Server Analysis Services atau SQL Server Reporting Services jika database tersebut dihosting di server atau instans terpisah dari database konfigurasi.

TfsConfig remapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
	[/AnalysisInstance:<serverName>] [/AnalysisDatabaseName:<databaseName>]
	[/preview] [/continue]

Opsi	Deskripsi
DatabaseName	Menentukan nama server yang menghosting database yang ingin Anda petakan untuk Azure DevOps Server, selain nama database itu sendiri.
SQLInstances	Menentukan nama server yang menjalankan SQL Server, sebagai tambahan nama instans jika Anda ingin menggunakan instans selain instans default. Jika Anda menentukan lebih dari satu server, Anda harus menggunakan koma untuk memisahkan beberapa pasang nama server dan instans.
AnalysisInstance	Opsional. Menentukan nama server dan instans yang menghosting SQL Server Analysis Services. Gunakan opsi ini untuk menentukan server dan instans yang menghosting database Analysis Services.
AnalysisDatabaseName	Opsional. Menentukan nama database Analysis Services yang ingin Anda gunakan dengan Azure DevOps Server jika Anda memiliki lebih dari satu database tersebut di server yang Anda tentukan dengan opsi /AnalysisInstance.
pratinjau	Opsional. Menampilkan tindakan yang harus Anda ambil untuk memperbarui konfigurasi.
lanjutkan	Opsional. Menentukan bahwa perintah RemapDB harus dilanjutkan meskipun terjadi kesalahan selama upaya untuk menemukan satu atau beberapa database. Jika Anda menggunakan opsi /continue, koleksi apa pun yang databasenya tidak ditemukan di server atau server-server yang Anda tentukan akan dikonfigurasi ulang untuk menggunakan server dan instans yang menghosting database konfigurasi.

Prasyarat

Untuk menggunakan perintah remapDBs, Anda harus menjadi anggota kelompok keamanan Administrator Azure DevOps dan anggota keamanan sysadmin untuk semua instans SQL Server yang Azure DevOps Server gunakan. Untuk informasi selengkapnya, lihat Referensi izin untuk Azure DevOps Server.

Keterangan

Anda menggunakan perintah remapDBs untuk mengonfigurasi ulang Azure DevOps Server untuk menggunakan server dan instans SQL Server yang berbeda dari server dan instans dalam penginstalan asli.

Contoh

Contoh berikut menunjukkan cara mengalihkan Azure DevOps Server ke database konfigurasinya TFS_Configuration. Database ini dihosting pada ContosoMain pada instans bernama TeamDatabases. Database kumpulan proyeknya disimpan di ContosoMain\TeamDatabases dan instans default pada Contoso2.

TfsConfig remapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration
	/SQLInstances:ContosoMain\TeamDatabases,Contoso2

---

RepairJobQueue

Anda menggunakan perintah repairJobQueue untuk memperbaiki pekerjaan terjadwal yang berhenti berjalan untuk host penyebaran dan pengumpulan.

TfsConfig repairJobQueue

Prasyarat

Untuk menggunakan perintah repairJobQueue, Anda harus menjadi anggota grup administrator lokal pada komputer yang menjalankan TfsConfig. Anda juga harus menjadi anggota peran keamanan sysadmin untuk semua instans SQL Server yang digunakan oleh penyebaran Azure DevOps Server.

Keterangan

Anda biasanya akan menggunakan perintah repairJobQueue jika Anda melihat pekerjaan terjadwal tidak berjalan.
Perintah tidak mengambil argumen apa pun, dan mengharuskan penyebaran Azure DevOps Server dikonfigurasi.

Contoh

TfsConfig repairJobQueue

---

Pengaturan

Anda dapat menggunakan perintah pengaturan untuk mengotomatiskan perubahan pada uniform resource locator (URL) yang digunakan oleh antarmuka pemberitahuan dan untuk alamat server untuk Azure DevOps Server. Secara default, URL antarmuka pemberitahuan dan URL server cocok di Azure DevOps Server, tetapi Anda dapat mengonfigurasi URL terpisah. Misalnya, Anda mungkin ingin menggunakan URL yang berbeda untuk email otomatis yang Azure DevOps Server hasilkan. Anda harus menjalankan alat ini dari tingkat aplikasi untuk memperbarui semua server sehingga mereka menggunakan URL baru.

Untuk mengubah URL ini secara interaktif atau hanya untuk melihat pengaturan saat ini, Anda dapat menggunakan konsol administrasi untuk Azure DevOps. Lihat Referensi cepat terkait tugas administratif.

TfsConfig settings [/publicURL:URL]

Opsi	Deskripsi
publicUrl	Menentukan URL server tingkat aplikasi untuk Azure DevOps. Nilai ini disimpan dalam database konfigurasi untuk Azure DevOps.

Prasyarat

Untuk melakukan prosedur ini, Anda harus menjadi anggota kelompok keamanan Administrator Azure DevOps dan grup Administrator di server tingkat aplikasi. Untuk informasi selengkapnya, lihat Mengatur izin administrator untuk Azure DevOps Server.

Keterangan

Perintah pengaturan mengubah informasi koneksi untuk komunikasi server-ke-server dalam penyebaran Azure DevOps Server. URL yang ditentukan dalam /publicURL harus tersedia untuk semua server dalam penyebaran.

Contoh

Contoh berikut mengubah nilai NotificationURL menjadi http://contoso.example.com/tfs dan nilai ServerURL menjadi http://contoso.example.com:8080/tfs.

TfsConfig settings /publicURL:http://contoso.example.com:8080/tfs

---

Siapkan

Anda menggunakan perintah penyiapan untuk menghapus instalasi fitur yang saat ini dikonfigurasi pada komputer tempat Anda menjalankan perintah.

TfsConfig setup /uninstall:<feature[,feature,...]>

Opsi

Deskripsi

/uninstall

Menentukan satu atau beberapa fitur yang akan dihapus instalannya dari komputer tempat Anda menjalankan perintah. Opsi meliputi: Semua, ApplicationTier, Pencarian, dan VersionControlProxy.

Prasyarat

Untuk menggunakan perintah penyiapan, Anda harus menjadi anggota kelompok keamanan Administrator Azure DevOps.

Contoh

Contoh berikut menghapus instalan semua fitur Azure DevOps Server dari komputer saat ini.

TfsConfig setup /uninstall:All

Contoh berikut menghapus instalan tingkat aplikasi dan membangun fitur dari komputer saat ini.

TfsConfig setup /uninstall:ApplicationTier 

---

TCM

Saat meningkatkan ke versi terbaru Azure DevOps Server, sistem secara otomatis mencoba meningkatkan komponen Manajemen Pengujian, termasuk paket dan rangkaian pengujian.

Jika migrasi otomatis gagal, gunakan perintah TCM untuk meningkatkan paket pengujian dan rangkaian pengujian Anda secara manual ke jenis item kerja (WIT) masing-masing.

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName

Opsi

Deskripsi

/upgradeTestPlans

Diperlukan kecuali /upgradeStatus digunakan.

Mengonversi paket pengujian dan rangkaian pengujian yang ada untuk menunjuk ke paket pengujian dan rangkaian pengujian berbasis item kerja. Ini juga memperbarui data manajemen pengujian yang ada dan tautan antara artefak pengujian lain yang ada seperti titik pengujian, eksekusi pengujian, dan hasil pengujian.

/upgradeStatus

Diperlukan kecuali /upgradeTestPlans digunakan.

Melaporkan status migrasi data pengujian untuk proyek yang ditentukan. Ini juga akan menunjukkan apakah proyek yang ditentukan memiliki rencana pengujian.

/CollectionName: CollectionName

Wajib diisi. Menentukan kumpulan proyek yang berisi proyek yang ingin Anda migrasikan data pengujiannya atau periksa status migrasinya.

Jika ada spasi dalam nama koleksi proyek, sertakan nama dalam tanda kutip, misalnya, "Koleksi Fiber Fabrikam".

/TeamProjectName:TeamProjectName

Wajib diisi. Menentukan proyek yang ingin Anda migrasikan data pengujiannya atau periksa status migrasinya. Proyek ini harus ditentukan dalam koleksi yang Anda tentukan dengan menggunakan parameter /collectionName.

Jika ada spasi dalam nama proyek, sertakan nama dalam tanda kutip, misalnya, "My Project".

Prasyarat

Anda harus menjadi anggota kelompok keamanan Administrator Team Foundation dan administrator di server tingkat aplikasi.

Lihat Mengatur izin administrator untuk Azure DevOps Server.

Keterangan

Server tingkat aplikasi Anda harus ditingkatkan ke versi terbaru Azure DevOps Server 2019 untuk menggunakan perintah ini.

Sebelum dapat menggunakan perintah TCM, Anda harus terlebih dahulu mengimpor definisi item kerja paket pengujian dan kategori paket pengujian ke dalam proyek.

Untuk mempelajari selengkapnya tentang migrasi dan kapan menggunakan perintah ini, lihat Pembaruan manual untuk mendukung manajemen pengujian.

Perintah TCM diterapkan ke proyek individual. Jika Anda perlu meningkatkan paket pengujian di lebih dari satu proyek, Anda harus menjalankannya terhadap setiap proyek satu per satu.

Anda harus menjalankan perintah TCM dari direktori alat untuk Azure DevOps Server. Secara default, lokasi tersebut adalah: drive:\%programfiles%\TFS 12.0\Tools.

Anda hanya menggunakan perintah TCM jika migrasi otomatis data pengujian yang ada gagal.

Untuk mempelajari selengkapnya tentang migrasi dan kapan menggunakan perintah ini, lihat Pembaruan manual untuk mendukung manajemen pengujian. Jika Anda tidak dapat mengakses paket pengujian atau rangkaian pengujian yang ditentukan sebelum peningkatan server terjadi, jalankan TFSConfig TCM upgradeStatus untuk menentukan status migrasi.

Anda menjalankan perintah TCM untuk proyek individual. Jika Anda perlu meningkatkan paket pengujian di lebih dari satu proyek, Anda harus menjalankannya terhadap setiap proyek satu per satu.

Contoh

Contoh berikut menunjukkan cara memeriksa status peningkatan paket pengujian pada proyek Fabrikam Fiber yang dihosting pada koleksi proyek default (DefaultCollection):

tfsconfig tcm /upgradeStatus /CollectionName:DefaultCollection /TeamProject:"Fabrikam Fiber"

---

Tanpa pengawas

Ketersediaan perintah: Azure DevOps Server 2019

Perintah tanpa pengawas dirancang untuk pengguna yang terbiasa dengan Azure DevOps Server dan proses konfigurasi, dan yang perlu menginstal Azure DevOps Server pada komputer yang berbeda.

Misalnya, jika Anda menggunakan Azure DevOps Build, Anda dapat menggunakan perintah tanpa pengawas untuk menginstal beberapa server build menggunakan file konfigurasi yang sama.

Gunakan opsi /create untuk membuat file tanpa pengawas. File ini mendefinisikan semua parameter konfigurasi untuk penginstalan Azure DevOps Server. Selanjutnya, gunakan opsi /configure untuk benar-benar melakukan konfigurasi.

Proses ini memungkinkan Anda untuk mengonfigurasi Azure DevOps Server dari awal hingga akhir tanpa harus memberikan input selama proses penginstalan. Dalam kasus beberapa penginstalan, ini juga membantu memastikan bahwa parameter konfigurasi yang sama persis digunakan di beberapa server.

TfsConfig unattend /create|configure /type:InstallType /unattendfile:ConfigurationFileName 
    [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]

Opsi	Deskripsi
buat	Membuat file tanpa pengawas dengan nama dan parameter yang Anda tentukan.
konfigurasi	Mengonfigurasi Azure DevOps Server menggunakan file dan parameter tanpa pengawas yang Anda tentukan. Anda harus menggunakan /type atau /unattendfile dengan opsi ini.
jenis	Menentukan jenis konfigurasi yang akan digunakan. Saat Anda menggunakan /configure, diperlukan /type atau /unattendfile, tetapi Anda tidak dapat menggunakan keduanya.
unattendfile	Menentukan file tanpa pengawas untuk dibuat atau digunakan, tergantung pada apakah parameter awalnya adalah /create atau /configure. Saat Anda menggunakan /configure, diperlukan /unattendfile atau /type.
inputs	Opsional. Jika Anda menggunakan /create, tentukan pengaturan dan nilai yang akan digunakan saat membuat file tanpa pengawas. Jika Anda menggunakan /configure tentukan pengaturan dan nilai tambahan untuk digunakan bersama dengan file tanpa pengawas. Sebagai alternatif untuk menggunakan /inputs, Anda dapat mengedit file tanpa pengawas secara manual di editor teks biasa apa pun. Ini diperlukan untuk jenis input tertentu, seperti ServiceAccountPassword atau PersonalAccessToken karena nilai rahasia tersebut tidak dapat diatur menggunakan parameter /inputs.
verify	Opsional. Menentukan eksekusi konfigurasi yang hanya menyelesaikan pemeriksaan verifikasi berdasarkan file, input, dan jenis konfigurasi tanpa pengawas. Ini adalah alternatif untuk melakukan konfigurasi lengkap.
lanjutkan	Opsional. Menentukan bahwa /create atau /configure harus dilanjutkan terlepas dari peringatan dari pemeriksaan verifikasi.

InstallType	Deskripsi
NewServerBasic	Mengonfigurasi layanan pengembangan penting untuk Azure DevOps Server. Ini termasuk Kontrol Sumber, Item Kerja, Build, dan Pencarian opsional.
NewServerAdvanced	Mengonfigurasi layanan pengembangan penting dan memungkinkan konfigurasi integrasi opsional dengan Reporting Services.
Mutakhirkan	Meningkatkan Azure DevOps Server ke versi terkini dari rilis sebelumnya yang didukung.
PreProductionUpgrade	Uji peningkatan pada penyebaran Azure DevOps Server yang ada di lingkungan pra-produksi. Biasanya ini dilakukan menggunakan database yang dipulihkan dari cadangan produksi. Skenario ini menyertakan langkah-langkah tambahan untuk memastikan bahwa penyebaran baru tidak akan mengganggu penyebaran produksi.
ApplicationTierOnlyBasic	Mengonfigurasi tingkat aplikasi baru menggunakan pengaturan yang ada dari database konfigurasi yang disediakan. Opsi ini memungkinkan Anda untuk mendapatkan dan menjalankan tingkat aplikasi baru dengan cepat menggunakan pengaturan yang ada. Jika Anda menginginkan kemampuan untuk mengubah pengaturan yang ada, sebagai gantinya gunakan jenis Advanced ApplicationTierOnlyAdvanced.
ApplicationTierOnlyAdvanced	Mengonfigurasi tingkat aplikasi baru dengan kontrol penuh atas semua pengaturan. Pengaturan akan menjadi default ke nilai yang ada dari database konfigurasi yang disediakan. Jika Anda ingin mempertahankan semua pengaturan yang ada, sebagai gantinya gunakan jenis ApplicationTierOnlyBasic.
Kloning	Mengonfigurasi penyebaran Azure DevOps Server baru yang merupakan klon dari penyebaran yang ada. Ini biasanya dilakukan, menggunakan database yang dipulihkan dari cadangan produksi, untuk membuat lingkungan tempat perubahan konfigurasi, ekstensi, dan modifikasi lainnya dapat diuji. Skenario ini menyertakan langkah-langkah tambahan untuk memastikan bahwa penyebaran baru tidak akan mengganggu penyebaran produksi.
Proksi	Mengonfigurasi layanan proksi kontrol versi.

Prasyarat

• Anda harus menjadi anggota grup Administrator pada komputer tempat Anda menginstal perangkat lunak.

• Bergantung pada jenis penginstalan, Anda mungkin juga memerlukan izin administrator tambahan.

Misalnya, jika Anda menggunakan perintah tanpa pengawas untuk menginstal Azure DevOps Server, Anda harus menjadi anggota grup sysadmin pada instans SQL Server yang akan mendukung Azure DevOps Server. Untuk informasi selengkapnya, lihat bagian Q & A di Menambahkan administrator tingkat server ke Azure DevOps Server.

Keterangan

Sebelum dapat menggunakan perintah tanpa pengawas untuk mengonfigurasi Azure DevOps Server, Anda harus membuat akun layanan yang akan Anda gunakan sebagai bagian dari penyebaran Anda. Anda juga harus menginstal perangkat lunak prasyarat apa pun untuk jenis penginstalan yang Anda pilih. Ini termasuk Azure DevOps Server itu sendiri. Anda harus menginstal Azure DevOps Server tetapi Anda tidak perlu mengonfigurasinya karena perintah tanpa pengawas akan melakukannya untuk Anda.

Perintah tanpa pengawas mengonfigurasi komponen Azure DevOps Server. Ini tidak melakukan penginstalan awal perangkat lunak. Ini mengonfigurasi perangkat lunak sesuai dengan spesifikasi Anda setelah bit ada di komputer.

Contoh

Contoh berikut menunjukkan cara membuat file tanpa pengawas untuk penginstalan dasar Azure DevOps Server.

TfsConfig unattend /create /type:basic /unattendfile:configTFSBasic.ini

Dalam contoh ini, file tanpa pengawas dibuat dalam direktori yang sama dengan perintah. File log dibuat sebagai bagian dari perintah, dan lokasi file dikembalikan dalam perintah sebagai bagian dari menjalankan perintah.

Contoh berikut menunjukkan cara menentukan repositori Git untuk digunakan dengan GVFS selama konfigurasi.

TfsConfig unattend /configure /type:proxy /inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection;GvfsProjectName=Fabrikam-Fiber-Git;GvfsRepositoryName=TestGit

Contoh berikut menunjukkan cara membuat file tanpa pengawas untuk konfigurasi Server Proksi Azure DevOps.

Penting

Dalam contoh ini, jika administrator ingin menggunakan token akses pribadi untuk autentikasi, mereka harus mengedit file secara manual untuk menentukan nilai token akses pribadi. Ini dapat dicapai dengan menambahkan baris untuk token akses pribadi dalam file tanpa pengawas yang dibuat seperti: PersonalAccessToken=PersonalAccessTokenValue.

TfsConfig unattend /create /type:proxy "/inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection" /unattendFile:c:\unattend.txt

Contoh berikut menunjukkan cara membuat file tanpa pengawas untuk konfigurasi Azure DevOps Server Build di server menggunakan FabrikamFiber\BuildSVC sebagai akun layanan build, lalu mengonfigurasi Azure DevOps Server Build menggunakan file tanpa pengawas tersebut.

Penting

Dalam contoh ini, setelah membuat file tanpa pengawas, administrator mengedit file secara manual untuk menentukan kata sandi untuk akun layanan build. Menambahkan kata sandi sebagai input menggunakan ServiceAccountPassword=Password; tidak menambahkan informasi kata sandi ke file.

TfsConfig unattend /create /type:build /unattendfile:configTFSBuild.ini
    /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

Perintah pertama mengembalikan hal berikut:

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203133.log

Perintah kedua mengembalikan informasi berikut, termasuk nama server tempat Azure DevOps Build dikonfigurasi FabrikamFiberTFS dan koleksi proyek yang terkait dengan pengontrol DefaultCollection:

    Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
    Copyright (c) Microsoft Corporation. All rights reserved.

    Command: unattend

    ---------------------------------------------
            Inputs:
    ---------------------------------------------

    Feedback
            Send Feedback: True

    Build Resources
            Configuration Type: create
            Agent Count: 1
            New Controller Name: FabrikamFiberTFS - Controller
            Clean Up Resources: False

    Project Collection
            Collection URL: http://FabrikamFiberTFS:8080/tfs/defaultcollection

    Windows Service
            Service Account: FabrikamFiber\BuildSVC
            Service Password: ********

    Advanced Settings *
            Port: 9191

    ---------------------------------------------
            Running Readiness Checks
    ---------------------------------------------

    [1/2] System Verifications
    [2/2] Build Service Verifications

    ---------------------------------------------
            Configuring
    ---------------------------------------------

            root
    [1/4] Install Team Foundation Build Service
            Installing Windows services ...
            Adding service account to groups ...
            Setting ACL on a windows service
    [2/4] Enable Event Logging
            Adding event log sources ...
            Token replace a config file
            RegisterBuildEtwProvider
            Configuring ETW event sources ...
    [3/4] Register with Team Foundation Server
            Registering the build service
    [4/4] Start Team Foundation Build Service
            StartBuildHost
            Starting Windows services ...
            Marking feature configured status
    [Info] [Register with Team Foundation Server] Firewall exception added for port
    9191

    TeamBuild completed successfully.
    Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203322.log

---

ZipLogs

Perintah ziplog dirancang untuk mengumpulkan log dan menghilangkan zip di ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs

---