Perintah proksi (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) tf proxy
mengonfigurasi komputer klien Anda untuk menggunakan server proksi. Perintah menambahkan, menghapus, dan mencantumkan rekaman proksi tentang lokasi dan ketersediaan satu atau beberapa server proksi dalam penyebaran Anda, termasuk situs jarak jauh apa pun.
Prasyarat
Untuk menggunakan proxy
perintah untuk mengonfigurasi komputer klien, Anda harus menjadi anggota grup keamanan Pengguna di komputer lokal. Untuk menggunakan proxy
perintah untuk bekerja dengan rekaman proksi, Anda harus memiliki izin AdminConfiguration .
Untuk informasi selengkapnya, lihat Namespace layanan keamanan dan referensi izin.
Sintaks
tf proxy ([/configure [Url]) [/collection:TeamProjectCollectionUrl]
[/login:UserName,[Password]]
tf proxy /add Url [/name:Name] [/site:SiteName]
[/description:Description] [/default:(global|site|all)]
[/collection:TeamProjectCollectionUrl] [/login:UserName,[Password]]
tf proxy /delete Url [/collection:TeamProjectCollectionUrl]
[/login:UserName,[Password]]
tf proxy /list [Url1 Yrl2 ...]
[/collection:TeamProjectCollectionUrl] [/login:UserName,[Password]]
tf proxy /enabled:(true|false)
Parameter
Argumen
Argumen
Keterangan
<url>
Mengidentifikasi server proksi. Anda harus menggunakan format http://<proxyServerName>:<proxyPortNumber>
, di mana proxyServerName
adalah nama server proksi dan proxyPortNumber
merupakan port mendengarkan yang ditetapkan, misalnya http://server:8081
.
<TeamProjectCollectionUrl>
Mengidentifikasi koleksi proyek. Anda harus menggunakan format http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>
. di mana ApplicationTierServerName
adalah nama server tingkat aplikasi, PortNumber
adalah port mendengarkan yang ditetapkan, dan Directory/CollectionName
merupakan nama direktori dan koleksi. Contohnya,http://server:8080/tfs/newcollection1
.
<username>
Menyediakan nilai untuk /login
opsi . Anda dapat menentukan nilai nama pengguna sebagai DOMAIN\username
atau username
.
<password>
Menyediakan kata sandi untuk nama pengguna.
Opsi
Opsi
Keterangan
/configure
Mengonfigurasi komputer klien Anda untuk menggunakan server proksi.
/collection
Menentukan koleksi proyek.
/login
Menentukan nama pengguna dan kata sandi untuk diautentikasi.
/add
Menambahkan catatan proksi ke Azure DevOps Server tentang lokasi dan ketersediaan server proksi di jaringan Anda.
/name
Mengaitkan nama dengan rekaman proksi.
/site
Mengaitkan domain Direktori Aktif dengan rekaman proksi.
/description
Menentukan deskripsi rekaman proksi.
/default
Menentukan cakupan rekaman proksi. Anda dapat menentukan salah satu nilai berikut:
global
site
all
Jika Anda menambahkan catatan proksi dengan default yang diatur ke global
, pertama kali pengembang melakukan get
operasi, Azure DevOps Server mengalihkan permintaan tersebut ke proksi yang ditentukan catatan global. Jika Anda menambahkan catatan proksi dengan default yang diatur ke site
, pertama kali pengembang dari dalam domain Direktori Aktif yang ditentukan melakukan get
operasi, Azure DevOps Server mengalihkan permintaan tersebut ke proksi yang ditentukan rekaman yang terkait dengan situs.
/delete
Menghapus rekaman proksi dari Azure DevOps Server.
/list
Mencantumkan rekaman proksi di server Azure DevOps.
/enabled
Mengaktifkan atau menonaktifkan proksi.
true
false
Keterangan
proxy
Perintah ini memiliki dua tujuan, dan setiap tujuan ditujukan untuk jenis pengguna yang berbeda.
Sebagai pengembang, Anda dapat menggunakan proxy
perintah untuk mengonfigurasi klien Anda untuk menggunakan server proksi atau untuk mengambil alih default jaringan untuk server proksi. Tugas ini mirip dengan mengonfigurasi Azure DevOps untuk menggunakan proksi.
Sebagai administrator jaringan, Anda dapat menggunakan proxy
perintah untuk menambahkan dan mengelola rekaman tentang lokasi berbagai server proksi dalam penyebaran Azure DevOps Server Anda. Anda dapat menggunakan rekaman ini untuk membantu pengembang mengonfigurasi stasiun kerja mereka untuk menggunakan proksi. Jika Anda menentukan proksi global, Azure DevOps Server dapat secara otomatis mengalihkan pengembang untuk menggunakannya.
Jika Anda memiliki topologi jaringan yang kompleks dengan beberapa domain Direktori Aktif di berbagai lokasi geografis, Anda dapat menyiapkan beberapa rekaman dan mengaitkan setiap rekaman dengan domain tertentu. Rekaman ini kemudian dapat membantu Anda mengarahkan pengembang secara otomatis dari setiap lokasi geografis ke proksi yang sesuai untuk lokasinya.
Untuk informasi selengkapnya tentang cara menggunakan tf
utilitas baris perintah, lihat Menggunakan perintah kontrol versi Team Foundation.
Contoh
Contoh berikut secara otomatis mendeteksi dan mengonfigurasi komputer klien untuk menggunakan proksi, jika rekaman proksi telah dibuat:
c:\projects>tf proxy /configure
Contoh berikut mengambil alih catatan proksi apa pun di Azure DevOps Server dan mengonfigurasi komputer klien untuk menggunakan proksi tertentu:
c:\projects>tf proxy /configure <Url>
Contoh berikut menambahkan catatan global ke Azure DevOps Server tentang ketersediaan server
proksi. Pertama kali pengembang melakukan get
operasi, Azure DevOps Server mengalihkan semua permintaan dari pengembang tersebut ke proksi yang ditentukan.
c:\projects>tf proxy /add http://server:8081 /default:global /collection:http://tfsserver:8080/
Contoh berikut menambahkan catatan situs ke Azure DevOps Server untuk pengembang di domain Direktori Aktif, yang diberi nama corp
, untuk menggunakan proksi ini server
. Pertama kali pengembang dari domain tersebut melakukan get
operasi, Azure DevOps Server mengalihkan semua permintaan dari pengembang tersebut ke proksi yang ditentukan.
c:\projects>tf proxy /add http://server:8081 /default:site /site:corp /collection:http://tfsserver:8080/