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/