Befehl Status
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 hierzu finden Sie unter Team Foundation Server-Berechtigungen.
tf status itemspec [/collection:TeamProjectCollectionUrl] [/login:username,[password]] ([/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 zum Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Versionskontrolle). .gif "Hinweis") Hinweis
Sie können mindestens ein Itemspec-Argument angeben.
|
TeamProjectCollectionUrl |
Die URL der Teamprojektauflistung, zu der Sie Statusinformationen anzeigen möchten (z. B. http://myserver:8080/tfs/DefaultCollection). |
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 |
Beschreibungen |
|---|---|
/collection |
Identifiziert die Teamprojektsammlung. |
/login |
Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an. |
/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 sowie Änderungen, die daran vor dem Eincheckvorgang vorgenommen wurden. Detailed zeigt vollständige Statusinformationen an. Der Standardwert ist Brief. |
/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 Shelvesets.
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 Befehlszeilenhilfsprogramms "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 zu allen ausstehenden Änderungen für den aktuellen Benutzer in allen Arbeitsbereichen der Auflistung angezeigt, die sich unter http://myserver:8080/tfs/DefaultCollection/ befindet.
c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:*
Im folgenden Beispiel werden Informationen zu allen noch nicht eingecheckten Änderungen von Joe in allen Arbeitsbereichen der Auflistung angezeigt, die sich unter http://myserver:8080/tfs/DefaultCollection/ befindet.
c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:* /user:Joe
Siehe auch
Referenz
Befehlszeilensyntax (Versionskontrolle)
Konzepte
Erstellen eines Arbeitsbereichs zum Arbeiten mit dem Teamprojekt