Udostępnij za pośrednictwem

Polecenie serwera proxy (Kontrola wersji programu Team Foundation)

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Program Visual Studio 2022

Polecenie Kontroli wersji programu Team Foundation (TFVC) tf proxy konfiguruje komputer kliencki do korzystania z serwera proxy. Polecenie dodaje, usuwa i wyświetla rekordy serwera proxy dotyczące lokalizacji i dostępności co najmniej jednego serwera proxy w ramach wdrożenia, w tym wszystkich lokacji zdalnych.

Warunki wstępne

Aby użyć polecenia proxy do skonfigurowania komputera klienckiego, należy do grupy zabezpieczeń użytkownik na komputerze lokalnym. Aby użyć polecenia proxy do pracy z rekordami serwera proxy, należy mieć uprawnienie AdminConfiguration. Aby uzyskać więcej informacji, zobacz Przestrzeń nazw zabezpieczeń i dokumentacja uprawnień.

Składnia

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)

Parametry

Argumenty

argumentów

opis

<url>

Identyfikuje serwer proxy. Należy użyć formatu http://<proxyServerName>:<proxyPortNumber>, gdzie proxyServerName jest nazwą serwera proxy, a proxyPortNumber jest przypisanym portem nasłuchiwania, na przykład http://server:8081.

<TeamProjectCollectionUrl>

Identyfikuje kolekcję projektów. Należy użyć formatu http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>. gdzie ApplicationTierServerName jest nazwą serwera warstwy aplikacji, PortNumber jest przypisanym portem nasłuchiwania, a Directory/CollectionName są nazwami katalogu i kolekcji. Na przykład http://server:8080/tfs/newcollection1.

<username>

Udostępnia wartość opcji /login. Możesz określić wartość nazwy użytkownika jako DOMAIN\username lub username.

<password>

Zawiera hasło dla nazwy użytkownika.

Opcje

opcji

opis

/configure

Konfiguruje komputer kliencki do używania serwera proxy.

/collection

Określa kolekcję projektów.

/login

Określa nazwę użytkownika i hasło do uwierzytelniania.

/add

Dodaje rekord serwera proxy do usługi Azure DevOps Server o lokalizacji i dostępności serwerów proxy w sieci.

/name

Kojarzy nazwę z rekordem serwera proxy.

/site

Kojarzy domenę usługi Active Directory z rekordem serwera proxy.

/description

Określa opis rekordu serwera proxy.

/default

Określa zakres rekordu serwera proxy. Możesz określić jedną z następujących wartości:

  • global
  • site
  • all

Jeśli dodasz rekord serwera proxy z ustawieniem domyślnym na global, po raz pierwszy deweloper wykonuje operację get, usługa Azure DevOps Server przekierowuje to żądanie do serwera proxy określonego przez rekord globalny. Jeśli dodasz rekord serwera proxy z domyślnym ustawionym na site, po raz pierwszy deweloper z określonej domeny usługi Active Directory wykonuje operację get, usługa Azure DevOps Server przekierowuje to żądanie do serwera proxy określonego rekordu skojarzonego z lokacją.

/delete

Usuwa rekord serwera proxy z usługi Azure DevOps Server.

/list

Wyświetla listę rekordów serwera proxy na serwerze Usługi Azure DevOps.

/enabled

Włącza lub wyłącza serwer proxy.

  • true
  • false

Uwagi

Polecenie proxy ma dwa cele, a każdy cel ma na celu inny typ użytkownika.

Jako deweloper możesz użyć polecenia proxy, aby skonfigurować klienta do używania serwera proxy lub przesłonić wartości domyślne sieci dla serwera proxy. To zadanie jest podobne do konfigurowania usługi Azure DevOps do korzystania z serwera proxy.

Jako administrator sieci możesz użyć polecenia proxy, aby dodać rekordy dotyczące lokalizacji różnych serwerów proxy i zarządzać nimi we wdrożeniu serwera Azure DevOps Server. Te rekordy umożliwiają deweloperom skonfigurowanie stacji roboczych do korzystania z serwera proxy. Jeśli zdefiniujesz globalny serwer proxy, usługa Azure DevOps Server będzie mogła automatycznie przekierowywać deweloperów do korzystania z niego.

Jeśli masz złożoną topologię sieci z wieloma domenami usługi Active Directory w różnych lokalizacjach geograficznych, możesz skonfigurować wiele rekordów i skojarzyć każdy rekord z określoną domeną. Te rekordy mogą następnie pomóc automatycznie kierować deweloperów z każdej lokalizacji geograficznej do odpowiedniego serwera proxy dla ich lokalizacji.

Aby uzyskać więcej informacji na temat korzystania z narzędzia wiersza polecenia tf, zobacz Używanie poleceń kontroli wersji programu Team Foundation.

Przykłady

Poniższy przykład automatycznie wykrywa i konfiguruje komputer kliencki do używania serwera proxy, jeśli został ustanowiony rekord serwera proxy:

c:\projects>tf proxy /configure

Poniższy przykład zastępuje wszystkie rekordy serwera proxy na serwerze Azure DevOps Server i konfiguruje komputer kliencki do używania określonego serwera proxy:

c:\projects>tf proxy /configure <Url>

W poniższym przykładzie do serwera Azure DevOps Server dodano rekord globalny dotyczący dostępności serwera proxy server. Po raz pierwszy deweloper wykonuje operację get, usługa Azure DevOps Server przekierowuje wszystkie żądania od tego dewelopera do określonego serwera proxy.

c:\projects>tf proxy /add http://server:8081 /default:global /collection:http://tfsserver:8080/

Poniższy przykład dodaje rekord lokacji do usługi Azure DevOps Server dla deweloperów w domenie usługi Active Directory o nazwie corp, aby użyć tego serwera proxy server. Po raz pierwszy deweloper z tej domeny wykonuje operację get, usługa Azure DevOps Server przekierowuje wszystkie żądania od tego dewelopera do określonego serwera proxy.

c:\projects>tf proxy /add http://server:8081 /default:site /site:corp /collection:http://tfsserver:8080/