Freigeben über

View-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Der view-Befehl der Team Foundation-Versionskontrolle (TFVC) ruft eine bestimmte Version einer Datei ab, speichert sie in einem temporären Ordner auf Ihrem Computer und zeigt sie an.

Voraussetzungen

Um den view-Befehl zu verwenden, müssen Sie die Leseberechtigung auf Zulassen festlegen. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

tf view [/collection:<team-project-collection-url>] [/console] [/recursive] [/output:<local-file>]
[/shelveset:<shelveset-name>[;<owner>]] [/noprompt] <item-spec> 
[/version:<version-spec>] [/login:<username>,[<password>]]

Parameter

In den folgenden Abschnitten werden Argumente und Optionen des view-Befehls beschrieben.

Argumente

Argument

Beschreibung

<team-project-collection-url>

Gibt die URL der Projektsammlung an, die eine bestimmte Version einer Datei enthält, zu der Sie Informationen abrufen möchten, z. B. https://myserver:8080/tfs/DefaultCollection.

<shelveset-name> [:<owner>]

Identifiziert das Shelveset. Das optionale <owner>-Argument wird verwendet, um ein Shelveset anzugeben, das nicht dem aktuellen Benutzer gehört.

<item-spec>

Identifiziert die abzurufende Datei oder den abzurufenden Ordner. Weitere Informationen darüber, wie TFVC das <item-spec>-Argument analysiert, um festzustellen, welche Elemente im Gültigkeitsbereich liegen, finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle – Verwenden von Optionen zum Ändern der Funktionsweise von Befehlen.

Hinweis

Sie können mehr als ein <item-spec>-Argument angeben.

<version-spec>

Stellt einen Wert wie C3 für die Option /version bereit. Weitere Informationen dazu, wie TFVC eine Versionsspezifikation analysiert, um zu bestimmen, welche Elemente in ihrem Gültigkeitsbereich liegen, finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

<username>

Stellt einen Wert für die Option /login bereit. Sie können diesen Wert als DOMAIN\<username> oder <username> angeben.

<password>

Stellt einen Wert für die Option /login bereit.

<local-file>

Stellt den Pfad zum Ordner der Ausgabedatei bereit.

Tastatur

Option

Beschreibung

/console

Gibt an, dass die Dateiausgabe an die Konsole weitergeleitet werden soll. Diese Option ist nützlich, wenn Sie die Datei mithilfe der Konsolenumleitung auf den Datenträger schreiben möchten, aber einen anderen Namen oder Speicherort als das Element mit Versionsangabe verwenden.

/recursive

Zeigt alle Elemente im angegebenen Verzeichnis und allen Unterverzeichnissen an.

/shelveset

Gibt das Shelveset über den Namen an.

/noprompt

Gibt an, dass TFVC Sie nicht auffordert, bevor jede Datei angezeigt wird, wenn Sie in einem <item-spec>-Argument einen Platzhalterausdruck verwenden, der auf mehr als eine Datei zutrifft.

/version

Gibt die Version der Datei an, die zur Ansicht geöffnet werden soll. Wenn Sie diese Option weglassen, ruft view die neueste Azure DevOps-Serverversion ab.

/collection

Gibt die Projektsammlung an.

/login

Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.

/output

Gibt die Datei in einem lokalen Ordner aus, anstatt eine Windows-Shell zum Öffnen der Datei aufzurufen.

Bemerkungen

Der view-Befehl des Hilfsprogramms tf ruft eine schreibgeschützte Kopie einer Datei vom Azure DevOps-Server ab, speichert die Datei in einem temporären Ordner auf Ihrem Computer und zeigt den Inhalt der Datei an. Sofern Sie keine bestimmte Version angeben, ruft TFVC die neueste Version der Datei vom Azure DevOps-Server ab.

Der view-Befehl fügt keine Dateien zu Ihrem Arbeitsbereich hinzu oder checkt sie aus. Weitere Informationen darüber, wie Sie die Azure DevOps-Serverversion einer Datei abrufen und auschecken können, finden Sie unter Get-Befehl und Checkout- und Edit-Befehl.

Sie können den difference-Befehl verwenden, um die Unterschiede zwischen zwei Versionen einer Datei anzuzeigen. Weitere Informationen finden Sie unter Difference-Befehl.

Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Ausgabeoptionen

  • Standardmäßig zeigt TFVC den Inhalt der Datei in dem Viewer an, der dem Dateityp zugeordnet ist.

  • Wenn Sie die Option /console angeben, gibt TFVC den Inhalt der Datei auf der Befehlskonsole aus. Wenn TFVC keinen Viewer für den von Ihnen angegebenen Dateityp finden kann, gibt es den Inhalt der Datei auf der Befehlskonsole aus.

  • Sie können den Inhalt einer Datei zur Standardausgabe umleiten, indem Sie | oder \> verwenden. Mit dieser Option können Sie die Datei in einer anderen Datei speichern oder sie an ein anderes Programm zur nachträglichen Verarbeitung weitergeben.

Beispiele

Im folgenden Beispiel wird die neueste Version der Datei 314.cs angezeigt:

c:\projects>tf view 314.cs

Im folgenden Beispiel wird die Version von 314.cs angezeigt, die mit Changeset 1999 eingecheckt wurde:

c:\projects>tf view /version:C1999 314.cs

Im folgenden Beispiel wird Version 5 von 314.cs abgerufen und in die Datei 314.old geschrieben:

c:\projects>tf view /version:5 314.cs > 314.old

Im folgenden Beispiel wird die neueste Version jeder Datei angezeigt, die dem Platzhalterausdruck *.cs entspricht:

c:\projects>tf view *.cs