Delen via

Proxyopdracht (Team Foundation Version Control)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Met de opdracht Team Foundation Version Control (TFVC) tf proxy configureert u uw clientcomputer voor het gebruik van een proxyserver. Met de opdracht worden proxyrecords toegevoegd, verwijderd en weergegeven over de locatie en beschikbaarheid van een of meer proxyservers binnen uw implementatie, inclusief externe sites.

Vereisten

Als u de proxy opdracht wilt gebruiken om een clientcomputer te configureren, moet u lid zijn van de gebruikersbeveiligingsgroep op de lokale computer. Als u de proxy opdracht wilt gebruiken om met proxyrecords te werken, moet u de machtiging Beheer Configuratie hebben. Zie Beveiligingsnaamruimte en machtigingsreferentie voor meer informatie.

Syntaxis

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)

Parameters

Argumenten

Argument

Beschrijving

<url>

Identificeert de proxyserver. U moet de indeling http://<proxyServerName>:<proxyPortNumber>gebruiken, waarbij proxyServerName de naam van de proxyserver is en proxyPortNumber de toegewezen luisterpoort is, bijvoorbeeld http://server:8081.

<TeamProjectCollectionUrl>

Identificeert de projectverzameling. U moet de indeling http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>gebruiken. waar ApplicationTierServerName is de naam van de server in de toepassingslaag, PortNumber is de toegewezen listening-poort en Directory/CollectionName zijn de namen van de map en de verzameling. Bijvoorbeeld: http://server:8080/tfs/newcollection1.

<username>

Biedt een waarde voor de /login optie. U kunt een gebruikersnaamwaarde opgeven als of DOMAIN\usernameusername.

<password>

Geeft een wachtwoord op voor de gebruikersnaam.

Opties

Optie

Beschrijving

/configure

Hiermee configureert u uw clientcomputer voor het gebruik van een proxyserver.

/collection

Hiermee geeft u de projectverzameling op.

/login

Hiermee geeft u de gebruikersnaam en het wachtwoord voor verificatie.

/add

Voegt een proxyrecord toe aan Azure DevOps Server over de locatie en beschikbaarheid van proxyservers in uw netwerk.

/name

Hiermee koppelt u een naam aan een proxyrecord.

/site

Hiermee koppelt u een Active Directory-domein aan een proxyrecord.

/description

Hiermee geeft u een beschrijving van de proxyrecord.

/default

Hiermee geeft u het bereik van de proxyrecord. U kunt een van de volgende waarden opgeven:

  • global
  • site
  • all

Als u een proxyrecord met de standaardinstelling globaltoevoegt, wordt de eerste keer dat een ontwikkelaar een get bewerking doet, azure DevOps Server die aanvraag omgeleid naar de proxy die door de globale record wordt opgegeven. Als u een proxyrecord met de standaardinstelling sitetoevoegt, wordt de eerste keer dat een ontwikkelaar vanuit het opgegeven Active Directory-domein een get bewerking uitvoert, door Azure DevOps Server die aanvraag omgeleid naar de proxy die door de record die aan de site is gekoppeld.

/delete

Hiermee verwijdert u een proxyrecord uit Azure DevOps Server.

/list

Geeft een lijst weer van proxyrecords in de Azure DevOps-server.

/enabled

Hiermee schakelt u een proxy in of uit.

  • true
  • false

Opmerkingen

De proxy opdracht heeft twee doelen en elk doel is gericht op een ander type gebruiker.

Als ontwikkelaar kunt u de proxy opdracht gebruiken om uw client te configureren voor het gebruik van een proxyserver of om de standaardinstellingen voor het netwerk voor een proxyserver te overschrijven. Deze taak is vergelijkbaar met het configureren van Azure DevOps voor het gebruik van een proxy.

Als netwerkbeheerder kunt u de proxy opdracht gebruiken om records toe te voegen en te beheren over de locatie van verschillende proxyservers binnen uw implementatie van Azure DevOps Server. U kunt deze records gebruiken om ontwikkelaars te helpen hun werkstations te configureren voor het gebruik van een proxy. Als u een globale proxy definieert, kan Azure DevOps Server ontwikkelaars automatisch omleiden om deze te gebruiken.

Als u een complexe netwerktopologie hebt met meerdere Active Directory-domeinen op verschillende geografische locaties, kunt u meerdere records instellen en elke record koppelen aan een bepaald domein. Deze records kunnen u vervolgens helpen ontwikkelaars automatisch van elke geografische locatie naar de juiste proxy voor hun locatie te leiden.

Zie Team Foundation-versiebeheeropdrachten gebruiken voor meer informatie over het gebruik van het tf opdrachtregelprogramma.

Voorbeelden

In het volgende voorbeeld wordt automatisch een clientcomputer gedetecteerd en geconfigureerd voor het gebruik van een proxy, als er een proxyrecord tot stand is gebracht:

c:\projects>tf proxy /configure

In het volgende voorbeeld worden proxyrecords op Azure DevOps Server overschreven en wordt een clientcomputer geconfigureerd voor het gebruik van een opgegeven proxy:

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

In het volgende voorbeeld wordt een globale record toegevoegd aan Azure DevOps Server over de beschikbaarheid van de server proxy. De eerste keer dat een ontwikkelaar een get bewerking uitvoert, stuurt Azure DevOps Server alle aanvragen van die ontwikkelaar om naar de opgegeven proxy.

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

In het volgende voorbeeld wordt een siterecord toegevoegd aan Azure DevOps Server voor ontwikkelaars in een Active Directory-domein met de naam corp, om deze server proxy te gebruiken. De eerste keer dat een ontwikkelaar van dat domein een get bewerking uitvoert, stuurt Azure DevOps Server alle aanvragen van die ontwikkelaar om naar de opgegeven proxy.

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