Proxy-Befehl (Team Foundation-Versionskontrolle)
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Der tf proxy
-Befehl der Team Foundation-Versionskontrolle (TFVC) konfiguriert Ihren Clientcomputer für die Verwendung eines Proxyservers. Der Befehl fügt Proxydatensätze zum Standort und zur Verfügbarkeit mindestens eines Proxyservers in Ihrer Bereitstellung hinzu oder löscht bzw. listet sie auf, einschließlich aller Remotestandorte.
Voraussetzungen
Um den proxy
-Befehl zum Konfigurieren eines Clientcomputers zu verwenden, müssen Sie Mitglied der Sicherheitsgruppe Benutzer auf dem lokalen Computer sein. Um den proxy
-Befehl zum Arbeiten mit Proxydatensätzen verwenden zu können, müssen Sie über die Berechtigung AdminConfiguration verfügen.
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 und proxyPortNumber
der zugewiesene Lauschport ist, z. B. http://server:8081
.
<TeamProjectCollectionUrl>
Identifiziert die Projektsammlung. Sie müssen das Format http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>
verwenden. Dabei ist ApplicationTierServerName
der Name des Servers der Anwendungsebene, PortNumber
der zugewiesene Lauschport und Directory/CollectionName
die Namen des Verzeichnisses und der Sammlung. Beispiel: http://server:8080/tfs/newcollection1
.
<username>
Stellt einen Wert für die /login
-Option bereit. Sie können einen Benutzernamenwert als DOMAIN\username
oder username
angeben.
<password>
Stellt ein Kennwort für den Benutzernamen bereit.
Tastatur
Option
Beschreibung
/configure
Konfiguriert Ihren Clientcomputer für die Verwendung eines Proxyservers.
/collection
Gibt die Projektsammlung an.
/login
Gibt den Benutzernamen und das Kennwort für die Authentifizierung an.
/add
Fügt Azure DevOps Server einen Proxydatensatz zum Standort und der Verfügbarkeit von Proxyservern in Ihrem Netzwerk hinzu.
/name
Ordnet einem Proxydatensatz einen Namen zu.
/site
Ordnet einem Proxydatensatz eine Active Directory-Domäne 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 hinzufügen, dessen Standardwert auf global
festgelegt ist, leitet Azure DevOps Server beim ersten Mal, wenn ein Entwickler einen get
-Vorgang ausführt, diese Anforderung an den Proxy um, der im globalen Datensatz angegeben ist. Wenn Sie einen Proxydatensatz hinzufügen, dessen Standardwert auf site
festgelegt ist, 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 um, den der mit dem Standort verbundene Datensatz angibt.
/delete
Löscht einen Proxydatensatz aus Azure DevOps Server.
/list
Löscht Proxydatensätze auf dem Azure DevOps-Server auf.
/enabled
Aktiviert oder deaktiviert einen Proxy.
true
false
Bemerkungen
Der Befehl proxy
dient zwei Zwecken, und jeder Zweck richtet sich an einen anderen Benutzertyp.
Als Entwickler können Sie den proxy
-Befehl verwenden, um Ihren Client für die Verwendung eines Proxyservers zu konfigurieren oder die Netzwerkstandardeinstellungen für einen Proxyserver zu überschreiben. Diese Aufgabe ähnelt dem Konfigurieren von Azure DevOps für die Verwendung eines Proxys.
Als Netzwerkadministrator können Sie den proxy
-Befehl verwenden, um Datensätze zum Standort verschiedener Proxyserver in Ihrer Bereitstellung von Azure DevOps Server hinzuzufügen und zu verwalten. Sie können diese Datensätze verwenden, um Entwickler bei der Konfiguration ihrer Arbeitsstationen für die Verwendung eines Proxys zu unterstützen. Wenn Sie einen globalen Proxy definieren, kann Azure DevOps Server Entwickler automatisch zu dessen Verwendung umleiten.
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 umzuleiten.
Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf
finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.
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 für Azure DevOps Server überschrieben, und es wird ein Clientcomputer für die Verwendung eines angegebenen Proxys konfiguriert:
c:\projects>tf proxy /configure <Url>
Das folgende Beispiel fügt Azure DevOps Server einen globalen Datensatz zur Verfügbarkeit des server
-Proxys hinzu. Wenn ein Entwickler zum ersten Mal einen get
-Vorgang ausführt, leitet Azure DevOps Server alle Anforderungen dieses Entwicklers an den angegebenen Proxy um.
c:\projects>tf proxy /add http://server:8081 /default:global /collection:http://tfsserver:8080/
Das folgende Beispiel fügt Azure DevOps Server einen Standortdatensatz für Entwickler in einer Active Directory-Domäne mit dem Namen corp
hinzu, 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 um.
c:\projects>tf proxy /add http://server:8081 /default:site /site:corp /collection:http://tfsserver:8080/