Proxy-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

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/