Befehl Status

Artikel
08/20/2007

Zeigt Informationen über ausstehende Änderungen an Elementen in einem oder mehreren Arbeitsbereichen an.

tf status itemspec [/server:servername] ([/workspace:workspacename[;workspaceowner]]
 | [/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.
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 Benutzers an, der das Shelveset erstellt hat.
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

Mit dem Befehl status können Sie eine Liste mit ausstehenden Änderungen in einem oder mehreren Arbeitsbereichen anzeigen. Eine ausstehende Änderung ist eine Datei- oder Ordnerrevision, die nicht an den Server übermittelt, aber in eine Differenzmenge 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 Quellcodeverwaltungsshelvesets.

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.

Befehlsausgabe

Wenn der Änderungstyp rename ist, wird der neue Name angezeigt. Weitere Informationen finden Sie unter Befehl Rename (Team Foundation-Quellcodeverwaltung).

Es gibt zwei Anzeigemodi: brief und detailed.

Mit /Format:brief zeigen Sie den Speicherort des Elements auf dem Server, den Sperrstatus und den Typ, 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. Der Ordner wird ausgelassen, wenn nur Elemente aus einem Ordner angegeben werden.

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

Sicherheit

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.

Siehe auch

Freigeben über

Befehl Status

Parameter

Hinweise

Befehlsausgabe

Beispiele

Sicherheit

Siehe auch

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen