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 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/