Status-Befehl (Team Foundation-Versionskontrolle)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2022

Der Befehl Team Foundation-Versionskontrolle (TFVC) status oder der zugehörige Alias statzeigt Informationen zu ausstehenden Änderungen an Dateien und Ordnern sowie ausstehenden Änderungskandidaten in einem oder mehreren Arbeitsbereichen an. Wenn Sie die /shelveset Option 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 der Versionskontrolle nicht hinzugefügt wird. Um alle kandidaten für ausstehende Änderungen in Visual Studio anzuzeigen, wechseln Sie zu Team Explorer>Pending ChangesExcluded Changes>, und wählen Sie dann Erkannt aus.

Voraussetzungen

Um den status Befehl verwenden zu können, müssen Sie über die Leseberechtigung für das Quellelement und die Berechtigungen Auschecken und Zusammenführen für den Zielordner auf Zulassen festgelegt sein. 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, gibt die URL der Projektauflistung an, die den Arbeitsbereich enthält, der die ausstehenden Änderungen enthält. Beispiel: http://myserver:8080/tfs/DefaultCollection.

Wenn nicht angegeben, wird standardmäßig davon ausgegangen, dass die Projektauflistung diejenige ist, die den Arbeitsbereich enthält, der dem aktuellen Verzeichnis zugeordnet ist.

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, ob das Element gesperrt ist, wie durch ein Sternchen * angegeben, lokaler Pfad und Benutzer, wenn die /collection Optionen und /workspace verwendet werden. Einige der Daten sind möglicherweise verkürzt.
  • Detailed: Zeigt eine vollständige Beschreibung jeder ausstehenden Änderung an. Zusätzlich zu den obigen 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 * enthält Daten zu Änderungen von allen Benutzern. 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 angeben workspaceowner , um Daten zu ausstehenden Änderungen in einem Arbeitsbereich abzurufen, der zu einem bestimmten Benutzer gehört. Wenn nicht angegeben, wird angenommen, dass der Arbeitsbereich der aktuelle Benutzer oder, falls angegeben, der /login:<username>ist.

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 dem aktuellen Verzeichnis zugeordnet ist, 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 Entwicklungscomputer vorgenommen wurden, indem Sie die /collectionOptionen , /userund /workspace verwenden. Sie können jedoch 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 wird davon ausgegangen, dass $/SiteApp/Main/ im Arbeitsbereich 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 der Änderungen in den Unterordnern:

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

Nächste Schritte