Freigeben über

Proxybefehl (Team Foundation Version Control)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022-

Der Befehl "Team Foundation Version Control" (TFVC) tf proxy konfiguriert Ihren Clientcomputer für die Verwendung eines Proxyservers. Der Befehl fügt Proxyeinträge hinzu, löscht und listet Proxyeinträge über den Standort und die Verfügbarkeit eines oder mehrerer Proxyserver in Ihrer Bereitstellung, einschließlich aller Remotestandorte, auf.

Voraussetzungen

Um den Befehl proxy zum Konfigurieren eines Clientcomputers zu verwenden, müssen Sie Mitglied der sicherheitsgruppe Benutzer auf dem lokalen Computer sein. Um den Befehl proxy zum Arbeiten mit Proxydatensätzen zu verwenden, verfügen Sie über die berechtigung AdminConfiguration. Weitere Informationen finden Sie unter Sicherheitsnamespace und Berechtigungsreferenz.

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)

Parameter

Argumente

Argument

Beschreibung

<url>

Identifiziert den Proxyserver. Sie müssen das Format http://<proxyServerName>:<proxyPortNumber>verwenden, wobei proxyServerName der Name des Proxyservers ist und proxyPortNumber der zugewiesene Überwachungsport ist, z. B. http://server:8081.

<TeamProjectCollectionUrl>

Identifiziert die Projektauflistung. Sie müssen das Format http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>verwenden. wobei ApplicationTierServerName der Name des Anwendungsebenenservers ist, ist PortNumber der zugewiesene Überwachungsport, und Directory/CollectionName sind die Namen des Verzeichnisses und der Sammlung. Beispiel: http://server:8080/tfs/newcollection1.

<username>

Stellt einen Wert für die Option /login bereit. Sie können einen Benutzernamenswert entweder als DOMAIN\username oder als usernameangeben.

<password>

Stellt ein Kennwort für den Benutzernamen bereit.

Optionen

Option

Beschreibung

/configure

Konfiguriert Ihren Clientcomputer für die Verwendung eines Proxyservers.

/collection

Gibt die Projektauflistung an.

/login

Gibt den Benutzernamen und das Kennwort für die Authentifizierung an.

/add

Fügt azure DevOps Server einen Proxydatensatz zum Standort und zur Verfügbarkeit von Proxyservern in Ihrem Netzwerk hinzu.

/name

Ordnet einen Namen einem Proxydatensatz zu.

/site

Ordnet eine Active Directory-Domäne einem Proxydatensatz zu.

/description

Gibt eine Beschreibung des Proxydatensatzes an.

/default

Gibt den Bereich des Proxydatensatzes an. Sie können einen der folgenden Werte angeben:

  • global
  • site
  • all

Wenn Sie einen Proxydatensatz mit dem Standardsatz auf globalhinzufügen, leitet Azure DevOps Server beim ersten Mal einen get Vorgang um, der an den Proxy weiterleitet, den der globale Datensatz angibt. Wenn Sie einen Proxydatensatz mit dem Standardsatz auf sitehinzufügen, leitet Azure DevOps Server beim ersten Mal, wenn ein Entwickler aus der angegebenen Active Directory-Domäne einen get Vorgang ausführt, diese Anforderung an den Proxy weiter, den der mit der Website verknüpfte Datensatz angibt.

/delete

Löscht einen Proxydatensatz aus Azure DevOps Server.

/list

Listet Proxyeinträge auf dem Azure DevOps-Server auf.

/enabled

Aktiviert oder deaktiviert einen Proxy.

  • true
  • false

Bemerkungen

Der Befehl proxy hat zwei Zwecke, und jeder Zweck richtet sich an einen anderen Benutzertyp.

Als Entwickler können Sie den Befehl proxy verwenden, um Ihren Client so zu konfigurieren, dass er einen Proxyserver verwendet oder die Netzwerkstandardwerte für einen Proxyserver außer Kraft setzen kann. Diese Aufgabe ähnelt dem Konfigurieren von Azure DevOps für die Verwendung eines Proxys.

Als Netzwerkadministrator können Sie den Befehl proxy verwenden, um Datensätze zum Standort verschiedener Proxyserver in Ihrer Bereitstellung von Azure DevOps Server hinzuzufügen und zu verwalten. Mithilfe dieser Einträge können Entwickler ihre Arbeitsstationen so konfigurieren, dass ein Proxy verwendet wird. Wenn Sie einen globalen Proxy definieren, kann Azure DevOps Server Entwickler automatisch umleiten, um ihn zu verwenden.

Wenn Sie über eine komplexe Netzwerktopologie mit mehreren Active Directory-Domänen an verschiedenen geografischen Standorten verfügen, können Sie mehrere Datensätze einrichten und jeden Datensatz einer bestimmten Domäne zuordnen. Diese Datensätze können Ihnen dann helfen, Entwickler automatisch von jedem geografischen Standort an den entsprechenden Proxy für ihren Standort zu leiten.

Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.

Beispiele

Im folgenden Beispiel wird automatisch ein Clientcomputer für die Verwendung eines Proxys erkannt und konfiguriert, wenn ein Proxydatensatz eingerichtet wurde:

c:\projects>tf proxy /configure

Im folgenden Beispiel werden alle Proxyeinträge auf Azure DevOps Server außer Kraft gesetzt und ein Clientcomputer für die Verwendung eines angegebenen Proxys konfiguriert:

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

Im folgenden Beispiel wird Azure DevOps Server einen globalen Eintrag zur Verfügbarkeit des server-Proxys hinzugefügt. Wenn ein Entwickler zum ersten Mal einen get Vorgang ausführt, leitet Azure DevOps Server alle Anforderungen von diesem Entwickler an den angegebenen Proxy um.

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

Im folgenden Beispiel wird Azure DevOps Server für Entwickler in einer Active Directory-Domäne, die corpgenannt wird, einen Websiteeintrag hinzugefügt, um diesen server Proxy zu verwenden. Wenn ein Entwickler aus dieser Domäne zum ersten Mal einen get Vorgang ausführt, leitet Azure DevOps Server alle Anforderungen von diesem Entwickler an den angegebenen Proxy weiter.

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