Workfold-Befehl (Team Foundation-Versionskontrolle)
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 Arbeitsbereichszuordnung erstellt einen clientseitigen Ordner, in den alle Dateien und Unterordner im Azure DevOps-Serverordner abgerufen werden, wenn Sie einen tf get 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