Bagikan melalui

Perintah proksi (Kontrol Versi Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Perintah tf proxy Team Foundation Version Control (TFVC) 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 perintah untuk mengonfigurasi komputer klien, jadilah anggota grup keamanan Pengguna di komputer lokal. Untuk menggunakan perintah untuk bekerja dengan rekaman proksi, miliki izin AdminConfiguration . Untuk informasi selengkapnya, lihat Namespace keamanan dan referensi izin.

Sintaksis

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

Deskripsi

<url>

Mengidentifikasi server proksi. Anda harus menggunakan format http://<proxyServerName>:<proxyPortNumber>, di mana proxyServerName adalah nama server proksi dan proxyPortNumber adalah 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 adalah nama direktori dan koleksi. Misalnya, http://server:8080/tfs/newcollection1.

<username>

Menyediakan nilai untuk opsi /login. Anda dapat menentukan nilai nama pengguna sebagai DOMAIN\username atau username.

<password>

Menyediakan kata sandi untuk nama pengguna.

Pilihan

Opsi

Deskripsi

/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 operasi get, 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 operasi get, Azure DevOps Server mengalihkan permintaan 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

Komentar

Perintah proxy memiliki dua tujuan, dan setiap tujuan ditujukan untuk jenis pengguna yang berbeda.

Sebagai pengembang, Anda dapat menggunakan perintah proxy 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 perintah proxy 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 utilitas baris perintah tf, 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 proksi server. Pertama kali pengembang melakukan operasi get, 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 server ini. Pertama kali pengembang dari domain tersebut melakukan operasi get, 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/