Udostępnij za pośrednictwem

Polecenie serwera proxy (Kontrola wersji serwera Team Foundation)

  • Artykuł

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

Visual Studio 2019 | Visual Studio 2022

Polecenie Kontrola wersji serwera Team Foundation (TFVC) tf proxy konfiguruje komputer kliencki do używania 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.

Wymagania wstępne

Aby użyć proxy polecenia do skonfigurowania komputera klienckiego, musisz być członkiem grupy zabezpieczeń Użytkownik na komputerze lokalnym. Aby użyć proxy polecenia do pracy z rekordami serwera proxy, musisz mieć uprawnienie Administracja Configuration. Aby uzyskać więcej informacji, zobacz Security namespace and permission reference (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

Opis

<url>

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

<TeamProjectCollectionUrl>

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

<username>

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

<password>

Zawiera hasło dla nazwy użytkownika.

Opcje

Opcja

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żna 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 ustawieniem domyślnym 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 przez rekord skojarzony 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ć proxy polecenia , aby skonfigurować klienta do używania serwera proxy lub zastąpić 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ć proxy polecenia , 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 tf narzędzia wiersza polecenia, zobacz Use Team Foundation version control commands (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 server serwera proxy. Po raz pierwszy, gdy 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 server serwera proxy. 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/