Befehl "Proxy"

  • Artikel

Konfiguriert den Clientcomputer für einen Proxyserver. Übernimmt das Hinzufügen, Löschen und Auflisten von Proxydatensätzen zu Speicherort und Verfügbarkeit eines oder mehrerer Proxyserver innerhalb der Bereitstellung, einschließlich Remotesites.

Erforderliche Berechtigungen

Um den proxy-Befehl zum Konfigurieren eines Clientcomputers verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Benutzer auf dem lokalen Computer sein. Um den proxy-Befehl verwenden und mit Proxydatensätzen arbeiten zu können, müssen Sie über die Berechtigung AdminConfigurations verfügen. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.

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

Argument

Beschreibungen

Url

Identifiziert den Proxyserver. Sie müssen das folgende Format verwenden: http://proxyServerName:proxyPortNumber.

Wobei proxyServerName der Name des Proxyservers und proxyPortNumber der zugewiesene überwachte Port ist (z. B. https://server:8081).

TeamProjectCollectionUrl

Identifiziert die Teamprojektsammlung. Sie müssen das folgende Format verwenden: http://Anwendungsebenen-Servername:Portnummer/Verzeichnis/Sammlungsname.

Wobei Anwendungsebenen-Servername der Name des Anwendungsebenenservers, Portnummer der zugewiesene überwachte Port und Verzeichnis/Sammlungsname die Namen des Verzeichnisses und der Auflistung sind (z. B. https://server:8080/tfs/neuesammlung1).

UserName

Gibt einen Wert für die /login-Option an. Sie können als Wert für einen Benutzernamen entweder Domäne\Benutzername oder Benutzername angeben.

Password

Stellt ein Kennwort für den Benutzernamen bereit.

Option

Beschreibungen

/configure

Konfiguriert den Clientcomputer für einen Proxyserver.

/collection

Gibt die Teamprojektsammlung an.

/login

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

/add

Fügt einen Proxydatensatz Visual Studio Team Foundation Server zum Speicherort und der Verfügbarkeit von Proxyservern auf dem 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. Wenn Sie einen Proxydatensatz mit dem Standardwert "global" hinzufügen und ein Entwickler zum ersten Mal einen GET-Vorgang ausführt, wird die Anforderung dieses Entwicklers von Team Foundation Server an den im globalen Datensatz angegebenen Proxy umgeleitet. Wenn Sie einen Proxydatensatz mit dem Standardwert "site" hinzufügen und ein Entwickler zum ersten Mal von innerhalb der angegebenen Active Directory-Domäne einen GET-Vorgang ausführt, wird die Anforderung dieses Entwicklers von Team Foundation Server an den Proxy weitergeleitet, der in dem der Site zugeordneten Datensatz angegeben ist.

Sie können einen der folgenden Werte angeben:

  • globales Element

  • Site

  • all

/delete

Löscht einen Proxydatensatz aus Team Foundation Server.

/list

Listet Proxydatensätze in Team Foundation Server auf.

/enabled

Aktiviert oder deaktiviert Proxy.

  • true

  • false

Hinweise

Der Proxybefehl hat zwei Zwecke, und jeder dieser Zwecke richtet sich an einen anderen Typ von Benutzer.

Als Entwickler können Sie den Proxybefehl verwenden, um den Client für die Verwendung eines Proxyservers zu konfigurieren oder um die Netzwerkstandards für einen Proxyserver zu überschreiben. Diese Aufgabe ähnelt der Konfiguration von Team Explorer für die Verwendung eines Proxys.

Als Netzwerkadministrator können Sie den Proxybefehl verwenden, um in Team Foundation Server Datensätze über die Position verschiedener Proxyserver innerhalb der Bereitstellung hinzuzufügen oder zu verwalten. Mithilfe dieser Datensätze können Sie Entwickler dabei unterstützen, einen Proxy für ihre Arbeitsstationen zu konfigurieren. Wenn Sie einen globalen Proxy definieren, kann Team Foundation Server Entwickler automatisch so umleiten, dass sie ihn verwenden. Wenn eine komplexe Netzwerktopologie mit mehreren Active Directory-Domänen an verschiedenen geografischen Standorten vorliegt, können Sie mehrere Datensätze einrichten, von denen jeder einer bestimmten Domäne zugeordnet ist. Mithilfe dieser Datensätze können Sie Entwickler an jedem geografischen Standort automatisch zum geeigneten Proxy für ihren Standort weiterleiten.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".

Beispiele

Das folgende Beispiel erkennt und konfiguriert einen Clientcomputer automatisch für die Verwendung eines Proxys, wenn ein Proxydatensatz festgelegt wurde:

c:\projects>tf proxy /configure

Im folgenden Beispiel werden alle Proxydatensätze auf Team Foundation Server überschrieben, und ein Clientcomputer wird für die Verwendung eines angegebenen Proxys konfiguriert:

c:\projects>tf proxy /configure Url

Im folgenden Beispiel wird ein globaler Datensatz Team Foundation Server zur Verfügbarkeit dieses Proxys hinzugefügt. Wenn ein Entwickler zum ersten Mal einen GET-Vorgang ausführt, leitet Team Foundation Server alle Anforderungen dieses Entwicklers weiter an den angegebenen Proxy.

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

Im folgenden Beispiel wird ein Sitedatensatz zu Team Foundation Server für Entwickler in einer Active Directory-Domäne hinzugefügt, die "corp" genannt wird und diesen Proxyserver verwenden soll. Wenn ein Entwickler in der Domäne zum ersten Mal einen GET-Vorgang ausführt, leitet Team Foundation Server alle Anforderungen dieses Entwicklers an den angegebenen Proxy weiter.

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

Siehe auch

Referenz

Befehlszeilensyntax (Versionskontrolle)

Weitere Ressourcen

Befehle des Befehlszeilenhilfsprogramms "Tf"

Änderungsprotokoll

Datum

Versionsgeschichte

Grund

Januar 2011

Thema hinzugefügt.

Informationsergänzung.