Sdílet prostřednictvím

Příkaz proxy (Správa verzí Team Foundation)

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Příkaz TFVC (Team Foundation Version Control) tf proxy nakonfiguruje klientský počítač tak, aby používal proxy server. Příkaz přidá, odstraní a vypíše záznamy proxy serveru o umístění a dostupnosti jednoho nebo více proxy serverů v rámci vašeho nasazení, včetně všech vzdálených lokalit.

Požadavky

Pokud chcete ke konfiguraci klientského počítače použít příkaz proxy, být členem skupiny zabezpečení Uživatel na místním počítači. Pokud chcete použít příkaz proxy pro práci se záznamy proxy serveru, mají oprávnění AdminConfiguration. Další informace naleznete v tématu Obor názvů zabezpečení a referenční informace o oprávnění.

Syntax

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

argumentu

popis

<url>

Identifikuje proxy server. Musíte použít formát http://<proxyServerName>:<proxyPortNumber>, kde proxyServerName je název proxy serveru a proxyPortNumber je přiřazený naslouchající port, například http://server:8081.

<TeamProjectCollectionUrl>

Identifikuje kolekci projektů. Je nutné použít formát http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>. kde ApplicationTierServerName je název aplikačního serveru, PortNumber je přiřazený naslouchající port a Directory/CollectionName jsou názvy adresáře a kolekce. Například http://server:8080/tfs/newcollection1.

<username>

Poskytuje hodnotu /login možnosti. Hodnotu uživatelského jména můžete zadat buď jako DOMAIN\username, nebo username.

<password>

Poskytuje heslo pro uživatelské jméno.

Volby

možnost

popis

/configure

Nakonfiguruje klientský počítač tak, aby používal proxy server.

/collection

Určuje kolekci projektů.

/login

Určuje uživatelské jméno a heslo k ověření.

/add

Přidá záznam proxy serveru do Azure DevOps Serveru o umístění a dostupnosti proxy serverů ve vaší síti.

/name

Přidruží název k záznamu proxy serveru.

/site

Přidruží doménu služby Active Directory k záznamu proxy serveru.

/description

Určuje popis záznamu proxy serveru.

/default

Určuje rozsah záznamu proxy serveru. Můžete zadat jednu z následujících hodnot:

  • global
  • site
  • all

Pokud přidáte proxy záznam s výchozím nastavením na global, vývojář poprvé provede operaci get, Azure DevOps Server přesměruje tuto žádost na proxy server, který určuje globální záznam. Pokud přidáte proxy záznam s výchozím nastavením na site, při prvním spuštění vývojáře ze zadané domény Active Directory provede get operaci, Azure DevOps Server přesměruje tuto žádost na proxy server, který záznam přidružený k lokalitě určuje.

/delete

Odstraní záznam proxy serveru z Azure DevOps Serveru.

/list

Vypíše záznamy proxy serveru Na serveru Azure DevOps.

/enabled

Povolí nebo zakáže proxy server.

  • true
  • false

Poznámky

Příkaz proxy má dva účely a každý účel je zaměřen na jiný typ uživatele.

Jako vývojář můžete pomocí příkazu proxy nakonfigurovat klienta tak, aby používal proxy server, nebo přepsat výchozí hodnoty sítě pro proxy server. Tato úloha se podobá konfiguraci Azure DevOps tak, aby používala proxy server.

Jako správce sítě můžete pomocí příkazu proxy přidat a spravovat záznamy o umístění různých proxy serverů v rámci nasazení Azure DevOps Serveru. Tyto záznamy můžete použít k tomu, aby vývojáři nakonfigurovali pracovní stanice tak, aby používali proxy server. Pokud definujete globální proxy server, Azure DevOps Server může automaticky přesměrovat vývojáře, aby ho mohli používat.

Pokud máte složitou síťovou topologii s více doménami služby Active Directory v různých geografických umístěních, můžete nastavit více záznamů a přidružit každý záznam ke konkrétní doméně. Tyto záznamy vám pak můžou pomoct automaticky směrovat vývojáře z jednotlivých geografických umístění na odpovídající proxy server pro jejich umístění.

Další informace o použití nástroje příkazového řádku tf naleznete v tématu Použití příkazů správy verzí Team Foundation.

Příklady

Následující příklad automaticky rozpozná a nakonfiguruje klientský počítač tak, aby používal proxy server, pokud byl vytvořen záznam proxy serveru:

c:\projects>tf proxy /configure

Následující příklad přepíše všechny záznamy proxy serveru na Azure DevOps Serveru a nakonfiguruje klientský počítač tak, aby používal zadaný proxy server:

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

Následující příklad přidá globální záznam do Azure DevOps Serveru o dostupnosti server proxy serveru. Když vývojář poprvé provede operaci get, Azure DevOps Server přesměruje všechny požadavky od daného vývojáře na zadaný proxy server.

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

Následující příklad přidá záznam webu do Azure DevOps Serveru pro vývojáře v doméně Active Directory, která má název corp, pro použití tohoto server proxy. Když vývojář z této domény poprvé provede operaci get, Azure DevOps Server přesměruje všechny požadavky od daného vývojáře na zadaný proxy server.

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