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

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

Visual Studio 2019 | Visual Studio 2022

Příkaz Správa verzí Team Foundation (TFVC) 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

Chcete-li použít proxy příkaz ke konfiguraci klientského počítače, musíte být členem skupiny zabezpečení uživatele v místním počítači. Pokud chcete použít proxy příkaz pro práci se záznamy proxy serveru, musíte mít oprávnění Správa Konfigurace. Další informace naleznete v tématu Obor názvů zabezpečení a referenční informace o oprávněních.

Syntaxe

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

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ů. Musíte 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 možnosti /login . Hodnotu uživatelského jména můžete zadat buď nebo DOMAIN\usernameusername.

<password>

Poskytuje heslo pro uživatelské jméno.

Možnosti

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 určit jednu z následujících hodnot:

  • global
  • site
  • all

Pokud přidáte proxy záznam s výchozím nastavením global, při první operaci vývojář get přesměruje server Azure DevOps tento požadavek na proxy server, který určuje globální záznam. Pokud přidáte proxy záznam s výchozím nastavením 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í proxy příkazu 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í proxy příkazu 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 tom, jak používat nástroj příkazového tf řádku, 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. Při prvním provedení get operace 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 serveru. Když vývojář z této domény poprvé provede get operaci, 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/