Befehl Status
Aktualisiert: November 2007
Zeigt Informationen über ausstehende Änderungen an Elementen in einem oder mehreren Arbeitsbereichen an.
Erforderliche Berechtigungen
Damit Sie den Befehl status verwenden können, muss die Berechtigung Lesen für alle angegebenen Dateien oder Ordner auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
tf status itemspec [/server:servername] [/workspace:workspacename[;workspaceowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
tf status itemspec [/server:servername] [/shelveset:shelvesetname[;shelvesetowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
Parameter
Argument |
Beschreibung |
|---|---|
itemspec |
Identifiziert die Datei oder den Ordner, für die bzw. den Details zum Status angezeigt werden sollen. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Team System). |
servername |
Der vom Benutzer angegebene Wert für die /server-Option. Beispiel: http://teamfoundation2:8080. |
workspacename |
Der vom Benutzer angegebene Wert für die /workspace-Option. |
workspaceowner |
Gibt den Namen des Benutzers an, der den Arbeitsbereich erstellt hat. |
shelvesetname |
Der vom Benutzer angegebene Wert für die /shelveset-Option. |
shelvesetowner |
Gibt den Namen des Shelveset-Besitzers an. |
username |
Gibt einen Wert für die /user-Option an. Der Wert für den Benutzernamen kann auf zwei Arten angegeben werden, die von den Netzwerkeinstellungen abhängig sind: DOMÄNE\Benutzername oder Benutzername. |
Option |
Beschreibung |
|---|---|
/server |
Identifiziert den Team Foundation Server. Diese Option ist erforderlich, wenn der Befehl von einem Verzeichnis aufgerufen wird, das keinem Arbeitsbereich zugeordnet ist. |
/workspace |
Gibt den Namen des Arbeitsbereichs an, für den Sie die Liste der Änderungen anzeigen möchten. Wenn diese Option nicht angegeben wird und Sie den Befehl aus einem Verzeichnis ausführen, das zu einem Arbeitsbereich hinzugefügt wurde, wird der aktuelle Arbeitsbereich verwendet. Diese Option kann nicht mit der Option /shelveset kombiniert werden. |
/shelveset |
Der Name des Shelvesets, für das Sie die Liste von Änderungen anzeigen möchten. Diese Option kann nicht mit der Option /workspace kombiniert werden. |
/format |
Das Format der Statusinformationen. Brief zeigt eine Liste von Änderungen an, die noch nicht eingecheckt wurden. Detailed zeigt die vollständigen Statusinformationen an. Brief ist der Standardwert. |
/recursive |
Zeigt Statusinformationen zu allen Elementen im angegebenen Verzeichnis und sämtlichen Unterverzeichnissen an. |
/user |
Filtert die Liste der Änderungen nach dem angegebenen Benutzer. Mit einem Sternchen (*) können Sie alle Benutzer darstellen. Der Standardwert ist der aktuelle Benutzer. |
Hinweise
Sie können den Befehl status verwenden, um eine Liste mit ausstehenden Änderungen anzuzeigen. Eine ausstehende Änderung ist eine Datei- oder Ordnerrevision, die nicht an den Server übermittelt, aber in ein Changeset mit Versionsangabe eingefügt wurde. Weitere Informationen finden Sie unter Ausstehende Änderungen.
Sie können auch mit der Option /shelveset Details über zurückgestellte Änderungen ohne Versionsangabe anzeigen, für die ein Shelveset vorhanden ist. Weitere Informationen über den Unterschied zwischen ausstehenden Änderungen und zurückgestellten Änderungen finden Sie unter Arbeiten mit Versionskontrollshelvesets.
Links zu anderen Team Foundation-Befehlen, unter denen Sie weitere Informationen über die Elemente auf dem Server und sämtliche zugeordnete Arbeitsbereiche erhalten, finden Sie unter Informationsbefehle.
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".
Befehlsausgabe
Wenn es sich beim ausstehenden Änderungstyp um rename handelt, wird der neue Name angezeigt. Weitere Informationen finden Sie unter Befehl Rename (Team Foundation-Versionskontrolle).
Es gibt zwei Anzeigemodi: brief und detailed.
Mit /Format:brief zeigen Sie den Dateinamen des Elements, die Änderung und den lokalen Pfad, sofern das Element gesperrt ist, den Typ der ausstehenden Änderung, die es darstellt, den Benutzer, der die Änderungen vorgenommen hat, und den Speicherort der Arbeitsbereichsversion des Elements auf dem Datenträger an. Die Ausgabe wird zunächst nach dem Ordner und dann nach dem Dateinamen im Ordner sortiert.
Mit /Format:detailed zeigen Sie mehrere Zeilen mit Informationen über die einzelnen ausstehenden Änderungen in der Ausgabe an. Die Ausgabe mit detailed enthält sämtliche Informationen der Ausgabe mit brief und zusätzlich noch Datum, Uhrzeit und andere Informationen.
Beispiele
Im folgenden Beispiel werden Informationen über alle ausstehenden Änderungen für den aktuellen Benutzer im aktuellen Arbeitsbereich angezeigt. Der aktuelle Arbeitsbereich ist der Arbeitsbereich, dem das lokale Verzeichnis zugeordnet ist.
c:\projects>tf status
Im folgenden Beispiel werden alle ausstehenden Änderungen für den aktuellen Benutzer unter d:\src auf dem aktuellen Computer angezeigt.
c:\projects>tf status/recursive d:\src
Im folgenden Beispiel werden alle ausstehenden Änderungen für den aktuellen Benutzer im Arbeitsbereich Beta1 angezeigt.
c:\projects>tf status/workspace:Beta1
Im folgenden Beispiel werden Statusinformationen zu allen ausstehenden Änderungen für den Benutzer Jason angezeigt.
c:\projects>tf status/user:Jason
Im folgenden Beispiel werden Statusinformationen zu allen ausstehenden Änderungen für alle Benutzer in allen Arbeitsbereichen auf dem Server angezeigt.
c:\projects>tf status/user:*
Im folgenden Beispiel werden Informationen über alle ausstehenden Änderungen für den aktuellen Benutzer in sämtlichen Arbeitsbereichen auf dem Server angezeigt, der sich auf teamserver2 befindet.
c:\projects>tf status/server:teamserver2 /workspace:*
Im folgenden Beispiel werden Informationen über alle Änderungen von Joe, die dieser noch nicht eingecheckt hat, in sämtlichen Arbeitsbereichen angezeigt, die dem Server teamserver2 zugeordnet sind.
c:\projects>tf status/server:teamserver2 /workspace:* /user:joe
Siehe auch
Konzepte
Arbeiten mit Versionskontrollarbeitsbereichen
Arbeiten mit Changesets der Versionskontrolle
Arbeiten mit Versionskontrollshelvesets
Referenz
Befehlszeilensyntax (Team System)
Weitere Ressourcen
Befehle des Befehlszeilendienstprogramms "Tf"
Vergleichen von Ordnern und Dateien in der Versionskontrolle