Befehl "Profile"
Sie können den profile-Befehl verwenden, um benannte Anmeldeprofile zu erstellen, zu kopieren, zu aktualisieren und zu löschen. Anmeldeprofile werden zum Herstellen einer Verbindung mit Instanzen von Visual Studio Team Foundation Server verwendet. Auf Profile, die Sie auf einem Computer erstellen, kann nur auf diesem Computer zugegriffen werden, und diese Profile können nur von allen Clients von Team Explorer Everywhere 2010 verwendet werden.
Sie können ein Anmeldeprofil festlegen, wenn Sie andere Befehle ausführen. Weitere Informationen finden Sie unter Using a Profile.
Erforderliche Berechtigungen
Es sind keine Berechtigungen für Team Foundation Server erforderlich, da alle Profile lokal auf dem Computer gespeichert werden, auf dem Sie Plattformübergreifender Befehlszeilenclient für Team Foundation Server ausführen, nämlich in Ihrem Basisverzeichnis.
tf profile -copy ExistingProfileName NewProfileName
tf profile -delete ProfileName
tf profile -edit [-string:PropertyName=[StringValue]...] [-boolean:PropertyName=[true|false]...] [-number:PropertyName=[Number...]] ExistingProfileName
tf profile -new [-string:PropertyName=[StringValue]...] [-boolean:PropertyName=[true|false]...] [-number:PropertyName=Number]...] NewProfileName
Parameter
Argument |
Beschreibung |
|---|---|
ExistingProfileName |
Gibt den Namen eines Profils an, das auf dem lokalen Computer vorhanden ist. |
NewProfileName |
Gibt einen neuen Profilnamen als Teil eines copy- oder new-Vorgangs an. |
PropertyName |
Gibt den Namen einer Eigenschaft an, die Sie für das Profil definieren oder aktualisieren möchten. Eine Liste allgemeiner Eigenschaften, ihrer Typen und Beschreibungen finden Sie unter Remarks. |
StringValue |
Gibt den Wert einer Eigenschaft mit dem Datentyp string an. |
Nummer |
Gibt den Wert einer Eigenschaft mit dem Datentyp number an. |
Option |
Beschreibung |
|---|---|
-copy |
Gibt das zu kopierende Quellprofil und den Namen des Zielprofils an. |
-delete |
Gibt das Profil an, das Sie von dem lokalen Computer löschen möchten. |
-edit |
Gibt das Profil auf dem lokalen Compuer an, das Sie aktualisieren möchten, sowie eine Liste mit Updates. |
-new |
Gibt das Profil und zugehörige Eigenschaften an, das bzw. die Sie auf dem lokalen Computer erstellen möchten. |
-string |
Gibt an, dass Sie eine Zeichenfolgeneigenschaft für das angegebene Profil hinzufügen oder aktualisieren möchten. Für diese Option ist ein Eigenschaftenname und ein optionaler Eigenschaftenwert erforderlich. |
-boolean |
Gibt an, dass Sie eine eine boolesche Eigenschaft für das angegebene Profil hinzufügen oder aktualisieren möchten. Für diese Option ist ein Eigenschaftenname und ein optionaler Wert erforderlich. |
-number |
Gibt an, dass Sie eine eine numerische Eigenschaft für das angegebene Profil hinzufügen oder aktualisieren möchten. Für diese Option ist ein Eigenschaftenname und ein optionaler Wert erforderlich. |
Hinweise
Alle Profile enthalten eine URL, die ein Team Foundation Server-Projekt angibt. Wenn Sie eine Verbindung zu einer Instanz von Visual Studio Team Foundation Server 2010 herstellen, gibt die URL auch eine Teamprojektsammlung an. Das Profil kann auch andere Verbindunsinformationen erhalten, beispielsweise Benutzeranmeldeinformationen und Netzwerkproxyeinstellungen.
Tipp
Bei Eigenschaftennamen muss die Groß-/Kleinschreibung beachtet werden.
In der folgenden Tabelle werden die gängigsten Profileigenschaften beschrieben:
Eigenschaft |
Type |
Beschreibung |
|---|---|---|
acceptUntrustedCertificates |
string |
Bei "true" akzeptiert Plattformübergreifender Befehlszeilenclient für Team Foundation Server SSL-(Secure Sockets Layer)-Zertifikate, die nicht ohne Fehler überprüft bzw. als vertrauenswürdig eingestuft werden können. Bei "false" oder wenn nicht angegeben, akzeptiert der Befehlszeilen-Client keine nicht vertrauenswürdigen SSL-Zertifikate. |
httpProxyEnableAuth |
boolean |
Bei "true" werden die HTTP-Proxyanmeldeinformationen in diesem Profil für die Authentifizierung bei einem HTTP-Proxy verwendet. Bei "false" oder wenn nicht angegeben findet keine Authentifizierung bei dem HTTP-Proxy statt. |
httpProxyEnabled |
boolean |
Bei "true" wird ein HTTP-Proxy verwendet, wenn Sie eine Verbindung zu einer Instanz von Team Foundation Server herstellen. Bei "false" oder wenn nicht angegeben wird kein HTTP-Proxy verwendet. |
httpProxyIgnoreGlobal |
boolean |
Bei "true" wird die URL des im Profil konfigurierten Proxyservers verwendet. Bei "false" oder wenn nicht angegeben wird der Wert der HTTP_PROXY-Umgebungsvariable als Proxyserver-URL verwendet. Wenn die httpProxyEnabled-Eigenschaft "false" ist oder nicht angegeben wurde, wird diese Eigenschaft ignoriert. |
httpProxyPassword |
string |
Gibt das Kennwort an, das zum Authentifizieren für den konfigurierten HTTP-Proxy verwendet wird. |
httpProxyUrl |
string |
Gibt die URL des HTTP-Proxyservers an. |
httpProxyUsername |
string |
Gibt den Benutzernamen an, der zum Authentifizieren für den konfigurierten HTTP-Proxy verwendet wird. |
password |
string |
Gibt das Kennwort an, das zum Authentifizieren für die Instanz von Team Foundation Server verwendet wird. Wenn diese Eigenschaft nicht definiert ist, kann Plattformübergreifender Befehlszeilenclient für Team Foundation Server bei Bedarf zur Eingabe des Kennworts auffordern. |
serverUrl |
string |
Gibt die URL der Instanz von Team Foundation Server oder für die Teamprojektsammlung an. |
tfProxyEnabled |
boolean |
Bei "true" wird die in diesem Profil für den Server verwendet, auf dem der Team Foundation Server-Proxy ausgeführt wird, wenn Dateien von einer Instanz von Team Foundation Serverheruntergeladen werden. Wenn dieser Wert "false" oder nicht angegeben ist, wird der Team Foundation Server-Proxy nicht verwendet. |
tfProxyIgnoreGlobal |
boolean |
Bei "true" wird die in diesem Profil definierte URL für den Server, auf dem der Team Foundation Server-Proxy ausgeführt wird, zum Beschleunigen von Dateitransfers verwendet. Bei "false" oder wenn nicht angegeben wird der Wert der TFSPROXY-Umgebungsvariable als Proxyserver-URL verwendet. Wenn die tfProxyEnabled-Eigenschaft "false" ist oder nicht angegeben wurde, wird diese Eigenschaft ignoriert. |
tfProxyUrl |
string |
Gibt die URL des Servers an, auf dem der Team Foundation Server-Proxy ausgeführt wird, und die verwendet wird, wenn Dateien von einer Instanz von Team Foundation Server heruntergeladen werden. |
useDefaultCredentials |
boolean |
Bei "true" und bei verfügbaren Standardanmeldeinformationen werden diese anstelle der in diesem Profil gespeicherten Anmeldeinformationen zum Authentifizieren für die Instanz von Team Foundation Server verwendet. Bei "false" oder wenn nicht angegeben werden die Anmeldeinformationen in diesem Profil anstelle jeglicher verfügbarer Standardanmeldeinformationen verwendet. Sie können diese Option angeben, wenn Sie die Kerberos-Authentifizierung verwenden möchten. Weitere Informationen finden Sie unter Authentifizierung per Kerberos-Ticket. |
userDomain |
string |
Gibt die Windows-Domäne an, die zum Authentifizieren für die Instanz von Team Foundation Server verwendet wird. Wenn diese Eigenschaft nicht angegeben ist, kann Plattformübergreifender Befehlszeilenclient für Team Foundation Server bei Bedarf zur Eingabe der Domäne auffordern. |
userName |
string |
Gibt den Benutzernamen an, der zum Authentifizieren für die Instanz von Team Foundation Server verwendet wird. Wenn diese Eigenschaft nicht angegeben ist, kann Plattformübergreifender Befehlszeilenclient für Team Foundation Server bei Bedarf zur Eingabe auffordern. |
Warnung
Alle Eigenschaften, einschließlich von Kennwörtern, werden im Profil und in den Cachedateien des Arbeitsbereichs als Nur-Text gespeichert. Diese Eigenschaften können von allen Personen angezeigt werden, die über Lesezugriff auf diese Dateien verfügen.
Sie können zwei Proxys als Teil des Profils angeben. Der erste Proxy wird aktiviert, wenn Sie httpProxyEnabled=true angeben und definiert den Proxy, der zum Herstellen einer Verbindung mit einer Instanz von Team Foundation Server verwendet wird. Der zweite Proxy wird aktiviert, wenn Sie tfProxyEnabled=true angeben und definiert den Proxy, der zum Herunterladen von Dateien von Team Foundation-Versionskontrolle verwendet wird.
Sie können den profiles-Befehl zum Anzeigen von Informationen über die auf dem lokalen Computer gespeicherten Profile verwenden. Weitere Informationen finden Sie unter Profiles-Befehl.
Beispiele
In dem folgenden Beispiel wird ein Profil in ein neues Profil mit dem Namen "MyProfile" kopiert.
tf profile -copy http://tfs01.xyz.example.com MyProfile
In dem folgenden Beispiel wird das Profil mit dem Namen "MyProfile" aktualisiert, um "httpProxy" zu deaktivieren.
tf profile -edit MyProfile -boolean:httpProxyEnabled=false
In dem folgenden Beispiel wird die tfProxyUrl-Eigenschaft gelöscht.
tf profile -edit MyProfile -string:tfProxyUrl=
In dem folgenden Beispiel wird ein komplexes Profil mit dem Namen "MyProxyProfile" erstellt. Das Beispiel erstreckt sich über mehrere Zeilen, damit es einfacher zu lesen ist.
tf profile -new MyProxyProfile \
-string:serverUrl=http://tfs01.xyz.example.com \
-string:userName=john \
-string:userDomain=company \
-string:password="Se^%cret1" \
-boolean:httpProxyEnabled=true \
-string:httpProxyUrl=http://proxy01.xyz.example.com \
-boolean:httpProxyEnableAuth=true \
-string:httpProxyUsername=john \
-string:httpProxyPassword="Pr8xyP&^ss" \
-boolean:tfProxyEnabled=true \
-string:tfProxyUrl=http://tfproxy01.xyz.example.com \
-boolean:acceptUntrustedCertificates=true
In dem folgenden Beispiel wird das Profil mit dem Namen "MyProfile" gelöscht.
tf profile -delete MyProfile
Verwenden eines Profils
Geben Sie zum Verwenden eines Profils mit dem Plattformübergreifender Befehlszeilenclient für Team Foundation Server den Namen des Profils mit der Option "/profile" an, wenn Sie einen Befehl ausführen. Geben Sie zum Verwenden des Profils "john@tfs01" beim Ausführen des workspace-Befehls die folgende Befehlszeile an:
tf -profile:john@tfs01 -workspaces