Arbeitsordnerbefehl (Team Foundation-Versionskontrolle)

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

Visual Studio 2019 | Visual Studio 2022

Mit dem Befehl Team Foundation-Versionskontrolle (TFVC) workfold werden Informationen zu den Zuordnungen zwischen Ihren Arbeitsbereichsordnern 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 die Berechtigung globale Arbeitsbereiche verwalten auf Zulassen festgelegt haben. 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 Projektauflistung, 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 nicht angegeben, es sei denn /unmap, , /cloakoder /decloak ist 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

Decloaks einen Ordner, 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 tf Befehlszeilenhilfsprogramms verwenden, um Arbeitsbereichszuordnungen 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 tfget Vorgang ausführen. Der get Vorgang funktioniert nicht, wenn der clientseitige Ordner verhüllt ist.

Sie können auch ein Sternchen (*) als Platzhalterzeichen verwenden, um einen Azure DevOps Server Ordner und seine unmittelbaren Elemente Ihrem lokalen Arbeitsbereich zuzuordnen. Diese Zuordnung wird häufig als einzelne Ordnerzuordnung bezeichnet.

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

Optionen für die Arbeitsbereichszuordnung

Eine Arbeitsbereichszuordnung ist eine Liste aktiver und verhüllter 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 verschließen, die über ein zugeordnetes übergeordnetes Element verfügen. Cloaking ist eine effektive Möglichkeit, die Geschwindigkeit von Batchvorgängen get zu verbessern und Speicherplatz auf dem Datenträger zu sparen.

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

Sie können die /unmap Optionen und /decloak verwenden, um zugeordnete und verhüllte Einträge selektiv aus der Arbeitsbereichszuordnung zu löschen.

Anwenden von Arbeitsbereichszuordnungen

Standardmäßig werden Arbeitsbereichszuordnungen 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 $/projectsC:\projects zu. Als Nächstes fügen Sie ein Projekt namens $/projects/project_one hinzu und führen dann 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 Mantel

Zuordnungen von nicht zugeordneten Ordnern, die sich unter einem verhüllten 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 ummantelt :

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 Arbeitsbereichszuordnung für den Ordner $/projects/project_one Azure DevOps-Server ersetzt:

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