Teilen über


Status-Befehl (Team Foundation-Versionskontrolle)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Der status-Befehl der Team Foundation-Versionskontrolle (TFVC) oder sein Alias stat zeigt Informationen zu ausstehenden Änderungen an Dateien und Ordnern und ausstehenden Änderungskandidaten in einem oder mehreren Arbeitsbereichen an. Wenn Sie die Option /shelveset verwenden, zeigt der Befehl Informationen zu ausstehenden Änderungen in einem Shelveset an.

Hinweis

Ein ausstehender Änderungskandidat ist eine Datei im Ordner oder Unterordner des Arbeitsbereichs, die noch nicht zur Versionskontrolle hinzugefügt wurde. Um alle ausstehenden Änderungskandidaten in Visual Studio anzuzeigen, wechseln Sie zu Team Explorer>Ausstehende Änderungen>Ausgeschlossene Änderungen, und wählen Sie dann Erkannt aus.

Voraussetzungen

Um den status-Befehl zu verwenden, müssen Sie die Berechtigung Lesen für das Quellelement und die Berechtigungen Auschecken und Zusammenführen für den Zielordner auf Zulassen festgelegt haben. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

Parameter

Argumente

Argument

Beschreibung

/collection: <TeamProjectCollectionUrl>

Wenn Sie die /workspace-Option verwenden, geben Sie die URL der Projektsammlung an, die den Arbeitsbereich mit den ausstehenden Änderungen enthält. Beispiel: http://myserver:8080/tfs/DefaultCollection.

Ohne Angabe der Option wird standardmäßig von der Projektsammlung ausgegangen, die den Arbeitsbereich enthält, der das aktuelle Verzeichnis zuordnet.

Dies wird ignoriert, wenn Sie die /workspace-Option nicht verwenden.

Hinweis

Informationen zu den Einschränkungen dieser Option finden Sie unter Bemerkungen.

/format

Gibt an, wie viele Details zu jeder ausstehenden Änderung angezeigt werden:

  • Brief (Standard): Zeigt eine Zeile zu jeder ausstehenden Änderung an, die Folgendes umfasst: Dateiname, Änderungen, Information, ob das Element gesperrt ist, was durch ein Sternchen * angezeigt wird, lokaler Pfad und Benutzer bei Verwendung der Optionen /collection und /workspace. Einige der Daten sind möglicherweise verkürzt.
  • Detailed: Zeigt eine vollständige Beschreibung jeder ausstehenden Änderung an. Zusätzlich zu den oben genannten Informationen zeigt diese Option weitere Daten wie Datum und Uhrzeit an.

<itemspec>

Gibt die Elemente an, für die Sie Daten zu ausstehenden Änderungen wünschen. Weitere Informationen zur Syntax finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle. Sie können mehrere itemspec-Argumente angeben.

/login

Gibt das zur Ausführung des Befehls zu verwendende Benutzerkonto an. Weitere Informationen finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/recursive

Ruft rekursiv Daten zu ausstehenden Änderungen für Elemente im angegebenen Verzeichnis und in sämtlichen Unterverzeichnissen ab.

/shelveset:<shelvesetname>[;<shelvesetowner>]

Gibt das Shelveset an, das die aufzuführenden Änderungen enthält.

Diese Option kann nicht mit der /workspace-Option kombiniert werden.

/user

Führt alle ausstehenden Änderungen auf, die von einem angegebenen Benutzer vorgenommen wurden. Ein Sternchen * bezieht Daten zu Änderungen von allen Benutzern ein. Der Standardwert ist der aktuelle Benutzer.

Zulässige Werte für diese Option:

  • <username>
  • <useraccount>
  • Sternchen *

Hinweis

Informationen zu den Einschränkungen dieser Option finden Sie unter Bemerkungen.

/workspace:<workspacename>[;<workspaceowner>]

Gibt den Namen des Arbeitsbereichs an, der die ausstehenden Änderungen enthält. Wenn nicht angegeben, ist der Arbeitsbereich der, dem das aktuelle Verzeichnis zugeordnet ist.

Sie können workspaceowner angeben, um Daten über ausstehende Änderungen in einem Arbeitsbereich abzurufen, der einem bestimmten Benutzer gehört. Wenn nicht angegeben, wird davon ausgegangen, dass der Arbeitsbereich zum aktuellen Benutzer gehört, oder wenn angegeben, zu /login:<username>.

Diese Option kann nicht mit der /shelveset-Option kombiniert werden.

Hinweis

Informationen zu den Einschränkungen dieser Option finden Sie unter Bemerkungen.

Bemerkungen

Sie können den status-Befehl verwenden, um ausstehende Änderungen im aktuellen Arbeitsbereich anzuzeigen, z. B. den Arbeitsbereich, der das aktuelle Verzeichnis zuordnet, unabhängig davon, ob es sich um einen lokalen Arbeitsbereich oder einen Serverarbeitsbereich handelt. Sie können diesen Befehl auch verwenden, um ausstehende Änderungen in einem Remoteserverarbeitsbereich anzuzeigen, z. B. Änderungen, die von einem anderen Benutzer auf einem anderen Entwicklercomputer vorgenommen wurden, indem Sie die Optionen /collection, /user und /workspace verwenden. Allerdings können Sie ausstehende Änderungen in einem lokalen Remotearbeitsbereich nicht anzeigen.

Weitere Informationen finden Sie unter Entscheiden zwischen der Verwendung eines lokalen und eines Serverarbeitsbereichs.

Beispiele

In allen folgenden Beispielen gehen Sie davon aus, dass $/SiteApp/Main/ im Arbeitsbereich zu c:\code\SiteApp\Main\ zugeordnet ist.

Führen Sie alle Änderungen im aktuellen Arbeitsbereich auf

Im folgenden Beispiel werden alle ausstehenden Änderungen im Arbeitsbereich aufgelistet:

c:\code\SiteApp\Main\SolutionA\>tf stat

Führen Sie alle Änderungen in einem Ordner auf

Im folgenden Beispiel werden alle ausstehenden Änderungen an allen Elementen im Ordner SolutionA aufgelistet:

c:\code\SiteApp\Main>tf stat SolutionA\*

Führen Sie alle Änderungen in einem Ordner und dessen Unterordnern auf

Im folgenden Beispiel werden ausstehende Änderungen an allen Elementen im Ordner SolutionA aufgelistet, einschließlich Änderungen in den Unterordnern:

c:\code\SiteApp\Main>tf stat SolutionA\* /recursive

Nächste Schritte