Dela via


Proxykommando (Versionskontroll för Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

Kommandot Team Foundation Version Control (TFVC) tf proxy konfigurerar klientdatorn till att använda en proxyserver. Kommandot lägger till, tar bort och listar proxyposter om platsen och tillgängligheten för en eller flera proxyservrar i distributionen, inklusive fjärrplatser.

Förutsättningar

Om du vill använda proxy kommandot för att konfigurera en klientdator måste du vara medlem i användarsäkerhetsgruppen på den lokala datorn. Om du vill använda proxy kommandot för att arbeta med proxyposter måste du ha behörigheten AdminConfiguration . Mer information finns i Säkerhetsnamnrymd och behörighetsreferens.

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)

Parametrar

Argument

Argument

Beskrivning

<url>

Identifierar proxyservern. Du måste använda formatet http://<proxyServerName>:<proxyPortNumber>, där proxyServerName är namnet på proxyservern och proxyPortNumber är den tilldelade lyssningsporten, till exempel http://server:8081.

<TeamProjectCollectionUrl>

Identifierar projektsamlingen. Du måste använda formatet http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>. där ApplicationTierServerName är namnet på programnivåservern, PortNumber är den tilldelade lyssnarporten och Directory/CollectionName är namnen på katalogen och samlingen. Exempel: http://server:8080/tfs/newcollection1

<username>

Ger alternativet ett värde /login . Du kan ange ett användarnamnsvärde som antingen DOMAIN\username eller username.

<password>

Innehåller ett lösenord för användarnamnet.

Alternativ

Alternativ

Beskrivning

/configure

Konfigurerar klientdatorn så att den använder en proxyserver.

/collection

Anger projektsamlingen.

/login

Anger användarnamnet och lösenordet som ska autentiseras.

/add

Lägger till en proxypost i Azure DevOps Server om platsen och tillgängligheten för proxyservrar i nätverket.

/name

Associerar ett namn med en proxypost.

/site

Associerar en Active Directory-domän med en proxypost.

/description

Anger en beskrivning av proxyposten.

/default

Anger omfånget för proxyposten. Ange något av följande värden:

  • global
  • site
  • all

Om du lägger till en proxypost med standardvärdet global, första gången en utvecklare utför en get åtgärd, omdirigerar Azure DevOps Server den begäran till proxyn som den globala posten anger. Om du lägger till en proxypost med standardvärdet site, första gången en utvecklare inifrån den angivna Active Directory-domänen utför en get åtgärd, omdirigerar Azure DevOps Server begäran till den proxy som posten som är associerad med platsen anger.

/delete

Tar bort en proxypost från Azure DevOps Server.

/list

Visar en lista över proxyposter i Azure DevOps-servern.

/enabled

Aktiverar eller inaktiverar en proxy.

  • true
  • false

Kommentarer

Kommandot proxy har två syften och varje syfte riktar sig till en annan typ av användare.

Som utvecklare kan du använda proxy kommandot för att konfigurera klienten att använda en proxyserver eller för att åsidosätta nätverkets standardvärden för en proxyserver. Den här uppgiften liknar att konfigurera Azure DevOps för att använda en proxy.

Som nätverksadministratör kan du använda proxy kommandot för att lägga till och hantera poster om platsen för olika proxyservrar i din distribution av Azure DevOps Server. Du kan använda dessa poster för att hjälpa utvecklare att konfigurera sina arbetsstationer så att de använder en proxy. Om du definierar en global proxy kan Azure DevOps Server automatiskt omdirigera utvecklare till att använda den.

Om du har en komplex nätverkstopologi med flera Active Directory-domäner på olika geografiska platser kan du konfigurera flera poster och associera varje post med en viss domän. Dessa poster kan sedan hjälpa dig att automatiskt dirigera utvecklare från varje geografisk plats till lämplig proxy för deras plats.

Mer information om hur du använder tf kommandoradsverktyget finns i Använda Team Foundation-versionskontrollkommandon.

Exempel

I följande exempel identifieras och konfigureras automatiskt en klientdator att använda en proxy, om en proxypost har upprättats:

c:\projects>tf proxy /configure

I följande exempel åsidosätts alla proxyposter på Azure DevOps Server och en klientdator konfigureras för att använda en angiven proxy:

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

I följande exempel läggs en global post till i Azure DevOps Server om proxyns server tillgänglighet. Första gången en utvecklare utför en get åtgärd omdirigerar Azure DevOps Server alla begäranden från utvecklaren till den angivna proxyn.

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

I följande exempel läggs en webbplatspost till i Azure DevOps Server för utvecklare i en Active Directory-domän med namnet corp, för att använda den här server proxyn. Första gången en utvecklare från den domänen utför en get åtgärd omdirigerar Azure DevOps Server alla begäranden från utvecklaren till den angivna proxyn.

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