Workfold-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Mit dem workfold-Befehl der Team Foundation-Versionskontrolle (TFVC) werden Informationen zu den Zuordnungen zwischen Ihren Arbeitsbereichordnern und den Ordnern auf dem Azure DevOps-Server für TFVC erstellt, geändert oder angezeigt.

Voraussetzungen

Um den workfold-Befehl verwenden zu können, müssen Sie der Besitzer des angegebenen oder implizierten Arbeitsbereichs sein, oder für Sie muss die globale Berechtigung Arbeitsbereiche verwalten auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

tf workfold <local-folder> [/login:<username>,[<password>]]

tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]

tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>

tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>] 
[/workspace:<workspace-name>][/login:<username>,[<password>]

tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] 
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]

tf workfold /cloak 
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]

tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]

Parameter

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

Argumente

Argument

Beschreibung

<workspace-name>

Gibt den Namen des Arbeitsbereichs an, für den der Befehl mit der /workspace-Option ausgeführt wird.

<server-folder>

Gibt den Namen eines Azure DevOps-Serverordners an.

<local-folder>

Gibt den Namen eines lokalen Ordners an.

<team-project-collection-url>

Die URL der Projektsammlung, die die Ordner enthält, die Sie mit Serverordnern vergleichen möchten, z. B. https://myserver:8080/tfs/DefaultCollection/.

<username>

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

<password>

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

Tastatur

Option

Beschreibung

/workspace

Gibt den Namen des Arbeitsbereichs an, in dem gearbeitet werden soll.

/map

Gibt eine Zuordnung zwischen einem lokalen Ordner und dem Azure DevOps-Serverordner an. Standardmäßig verwendet der workfold-Befehl diese Option auch, wenn sie nicht angegeben wird, es sei denn /unmap, /cloak oder /decloak wird angegeben.

/unmap

Gibt an, welche Ordnerzuordnung aus dem Arbeitsbereich entfernt werden soll.

/cloak

Gibt an, dass der Ordner von allen Versionskontrollaktionen ausgeschlossen werden soll, die im Arbeitsbereich ausgeführt werden.

/decloak

Hebt die Verdeckung eines Ordners auf, sodass der Ordner im Arbeitsbereich abgerufen werden kann.

/collection

Gibt die Projektsammlung an.

/login

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

Hinweise

Sie können den workfold-Befehl des Befehlszeilenhilfsprogramms tf verwenden, um Arbeitsbereichzuordnungen zu erstellen und zu bearbeiten. Eine Arbeitsbereichzuordnung erstellt einen clientseitigen Ordner, in den alle Dateien und Unterordner im Azure DevOps-Serverordner abgerufen werden, wenn Sie einen tfget-Vorgang ausführen. Der get-Vorgang funktioniert nicht, wenn der clientseitige Ordner verdeckt ist.

Sie können auch ein Sternchen (*) als Platzhalterzeichen verwenden, um einen Azure DevOps-Serverordner und seine unmittelbaren Elemente Ihrem lokalen Arbeitsbereich zuzuordnen. Diese Zuordnung wird häufig als Zuordnung eines einzelnen Ordners bezeichnet.

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

Optionen für die Arbeitsbereichzuordnung

Eine Arbeitsbereichzuordnung ist eine Liste aktiver und verdeckter Elemente. Sie können der zugeordneten Liste im Arbeitsbereich Azure DevOps-Serverelemente hinzufügen, indem Sie die /map-Option verwenden. Sie können ein Element auch explizit aus dem Arbeitsbereich ausschließen, indem Sie die /cloak-Option verwenden. Sie können nur Elemente verdecken, die über ein zugeordnetes übergeordnetes Element verfügen. Verdeckung ist eine effektive Möglichkeit, die Geschwindigkeit von get-Batchvorgängen zu verbessern und Speicherplatz auf dem Datenträger einzusparen.

Verwenden Sie Verdeckung mit Bedacht. Um Kompilierungs- und Integrationsprobleme zu vermeiden, sollten Sie nur die Elemente verdecken, von denen Sie wissen, dass sie außerhalb des Geltungsbereichs Ihrer aktuellen und zukünftigen Projekte leigen, z. B. Bilder und externe Dokumentationsdateien.

Sie können die /unmap- und /decloak-Optionen verwenden, um zugeordnete und verdeckte Einträge selektiv aus der Arbeitsbereichzuordnung zu löschen.

Anwenden von Arbeitsbereichzuordnungen

Standardmäßig werden Arbeitsbereichzuordnungen rekursiv angewendet. Wenn Sie einem Azure DevOps-Serverordner einen lokalen Ordner zuordnen, erstellt das System implizit eine Zuordnung zwischen allen aktuellen und zukünftigen Unterordnern.

Angenommen, Sie ordnen $/projects dem Verzeichnis C:\projects zu. Dann fügen Sie ein Projekt namens $/projects/project_one hinzu und führen den get-Befehl im Arbeitsbereich aus. In diesem Szenario erstellt TFVC automatisch einen lokalen Arbeitsordner namens project_one im Verzeichnis C:\projects .

Im folgenden Beispiel wird ein Sternchen (*) als Platzhalterzeichen verwendet, um einen Serverordner und seine unmittelbaren Elemente Ihrem lokalen Arbeitsbereich zuzuordnen:

tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject

Im folgenden Beispiel wird der workfold-Befehl verwendet, um die Zuordnung zu überschreiben, die automatisch zwischen $/projects/project_one und C:\projects\project_one erstellt wird:

tf workfold $/projects/project_one C:\DifferentWorkfold

Zuordnungen unter Verdeckungen

Zuordnungen von nicht verdeckten Ordnern, die sich unter einem verdeckten Ordner in der Versionskontrollhierarchie befinden, können Ihrem lokalen Arbeitsbereich zugeordnet werden.

Beispiele

Im folgenden Beispiel werden die Zuordnungen für den Arbeitsbereich angezeigt, in dem sich c:\projects befindet:

c:\projects>tf workfold

Im folgenden Beispiel wird der Ordner c:\projects\lib verdeckt:

c:\projects>tf workfold /cloak c:\projects\lib

Im folgenden Beispiel wird die Zuordnung für die lokale Datei word.cs angezeigt:

c:\projects>tf workfold word.cs

Im folgenden Beispiel wird der Ordner C:\DifferentWorkfold dem Azure DevOps-Serverordner $/projects/project_one zugeordnet und die vorherige Arbeitsbereichzuordnung für den Azure DevOps-Serverordner $/projects/project_one ersetzt:

c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold