Freigeben über

Befehl 'Ansicht' (Team Foundation Version Control)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022-

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

Voraussetzungen

Wenn Sie den Befehl view verwenden möchten, legen Sie die Berechtigung "Lesen" auf "zulassen" fest. Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.

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 Befehls view beschrieben.

Argumente

Argument

Beschreibung

<team-project-collection-url>

Stellt die URL der Projektauflistung bereit, die eine bestimmte Version einer Datei enthält, über die Sie Informationen abrufen möchten, z. B. https://myserver:8080/tfs/DefaultCollection.

<shelveset-name> [:<owner>]

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

<item-spec>

Identifiziert die abzurufende Datei oder den abzurufenden Ordner. Weitere Informationen dazu, wie TFVC das argument <item-spec> analysiert, um zu bestimmen, welche Elemente sich innerhalb des Bereichs befinden, finden Sie unter Verwenden von Steuerelementbefehlen für die Team Foundation-Version – Verwenden von Optionen zum Ändern der Funktionsweise eines Befehls.

Anmerkung

Sie können mehrere <item-spec> Argumente 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 Bereich enthalten sind, finden Sie unter Verwenden von Steuerelementbefehlen für die Team Foundation-Version.

<username>

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

<password>

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

<local-file>

Stellt den Pfad zum Ausgabedateiordner bereit.

Optionen

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 versionsgeschützte Element verwenden möchten.

/recursive

Zeigt alle Elemente im angegebenen Verzeichnis und alle Unterverzeichnisse an.

/shelveset

Gibt das Regalset anhand des Namens an.

/noprompt

Gibt an, dass TFVC Sie nicht auffordern sollte, bevor jede Datei angezeigt wird, wenn Sie einen Wildcardausdruck in ein <item-spec> Argument einfügen, das mehreren Dateien entspricht.

/version

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

/collection

Gibt die Projektauflistung an.

/login

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

/output

Gibt die Datei in einen lokalen Ordner aus, anstatt eine Windows-Shell aufzugeben, um die Datei zu öffnen.

Bemerkungen

Der view Befehl des Befehlszeilenprogramms 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 Dateiinhalt an. Sofern Sie keine bestimmte Version angeben, ruft TFVC die neueste Version der Datei vom Azure DevOps-Server ab.

Der Befehl view fügt Ihrem Arbeitsbereich keine Dateien hinzu oder checkt sie aus. Weitere Informationen zum Abrufen der Azure DevOps-Serverversion einer Datei und zum Auschecken finden Sie unter Befehl abrufen und Befehle "Auschecken und Bearbeiten".

Mit dem Befehl difference können Sie die Unterschiede zwischen zwei Versionen einer Datei anzeigen. Weitere Informationen finden Sie unter Befehl "Unterschied".

Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.

Ausgabeoptionen

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

  • Wenn Sie die Option /console einschließen, druckt TFVC den Inhalt der Datei in der Befehlskonsole. Wenn TFVC einen Viewer für den von Ihnen angegebenen Dateityp nicht finden kann, wird der Dateiinhalt in der Befehlskonsole gedruckt.

  • Sie können den Inhalt einer Datei mithilfe von | oder \>an die Standardausgabe umleiten. Diese Option bietet eine Möglichkeit, die Datei in einer anderen Datei zu speichern oder an ein anderes Programm zur Nachbearbeitung zu übergeben.

Beispiele

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

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.oldgeschrieben:

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

Im folgenden Beispiel wird die neueste Version jeder Datei angezeigt, die dem Wildcardausdruck *.csentspricht:

c:\projects>tf view *.cs