Befehl Workfold
Aktualisiert: November 2007
Erstellt Informationen über die Zuordnungen zwischen den Arbeitsbereichsordnern und den Ordnern auf dem Server für die Team Foundation-Versionskontrolle bzw. ändert diese oder zeigt sie an.
Erforderliche Berechtigungen
Damit Sie den workfold-Befehl ausführen können, müssen Sie Besitzer für den angegebenen oder impliziten Arbeitsbereich sein oder für die globale Berechtigung Arbeitsbereiche verwalten zugelassen sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
tf workfold localfolder
tf workfold [/workspace:workspacename]
tf workfold [/server:servername] [/workspace:workspacename]
serverfolder
tf workfold [/map serverfolder localfolder] [/server:servername]
[/workspace:workspacename] (serverfolder|localfolder)
tf workfold /unmap [/server:servername] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder)
tf workfold /cloak
(serverfolder|localfolder) [/workspace:workspacename] [/s:servername]
tf workfold /decloak (serverfolder|localfolder)
[/workspace:workspacename] [/s:servername]
Parameter
Argument |
Beschreibung |
|---|---|
servername |
Gibt den Namen vom Team Foundation Server für die /server-Option an. Beispiel: teamfoundation2. |
workspacename |
Gibt für die /workspace-Option den Namen des Arbeitsbereichs an, auf den sich der Befehl auswirkt. |
serverfolder |
Gibt den Namen eines Ordners auf dem Server für die Team Foundation-Versionskontrolle an. |
localfolder |
Gibt den Namen eines lokalen Ordners an. |
Option |
Beschreibung |
|---|---|
/server |
Identifiziert den Team Foundation Server. Diese Option ist erforderlich, wenn der Befehl von einem Verzeichnis aufgerufen wird, das keinem Arbeitsbereich zugeordnet ist. |
/workspace |
Gibt den Namen des Arbeitsbereichs an, in dem gearbeitet werden soll. |
/map |
Gibt eine Zuordnung zwischen einem lokalen Ordner und dem Ordner auf dem Server für die Team Foundation-Versionskontrolle an. Standardmäßig verwendet der Befehl workfold diese Option, auch wenn sie nicht angegeben wird, sofern nicht /unmap, /cloak oder /decloak angegeben wird. |
/unmap |
Gibt an, welche Ordnerzuordnung aus dem Arbeitsbereich entfernt werden soll. |
/cloak |
Gibt an, dass der Ordner von allen im Arbeitsbereich durchgeführten Versionskontrollaktionen ausgeschlossen werden soll. |
/decloak |
Macht einen Ordner sichtbar, damit dieser in den Arbeitsbereich abgerufen werden kann. |
Hinweise
Sie können mit dem Befehl workfold des Befehlszeilenprogramms tfArbeitsbereichszuordnungen erstellen und bearbeiten. Eine Arbeitsbereichszuordnung erstellt einen clientseitigen Ordner, in den alle Dateien und Unterordner im Team Foundation-Versionskontrolle-Serverordner abgerufen werden, wenn Sie einen tfget-Vorgang durchführen. Dieser get-Vorgang funktioniert nicht, wenn der clientseitige Ordner verdeckt ist.
Sie können auch ein Sternchen (*) angeben, um dem lokalen Arbeitsbereich einen Team Foundation Server-Ordner mit den unmittelbar untergeordneten Elementen zuzuordnen. Dies wird oft als Zuordnung eines einzelnen Ordners bezeichnet.
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".
Optionen für Arbeitsbereichszuordnung
Eine Arbeitsbereichszuordnung ist eine Liste von aktiven und verdeckten Elementen. Sie können Elemente des Servers für die Team Foundation-Versionskontrolle mithilfe der Option /map in der Zuordnungsliste im Arbeitsbereich hinzufügen. Sie können auch explizit ein Element aus dem Arbeitsbereich ausschließen, indem Sie die Option /cloak verwenden. Sie können nur die Elemente verdecken, denen ein übergeordnetes Element zugeordnet ist. Durch Verdecken lässt sich auf effiziente Weise die Geschwindigkeit von GET-Stapelvorgängen erhöhen und Speicherplatz auf dem Datenträger einsparen.
Verwenden Sie das Verdecken mit Umsicht. Um Probleme bei der Kompilierung und Integration zu vermeiden, sollten Sie nur die Elemente verdecken, die außerhalb des Umfangs des aktuellen und aller zukünftigen Projekte liegen, z. B. Bilder und externe Dokumentationsdateien.
Mit den Optionen /unmap und /decloak können Sie ausgewählte zugeordnete und verdeckte Elemente aus der Arbeitsbereichszuordnung löschen.
Anwenden von Arbeitsbereichszuordnungen
In der Standardeinstellung werden Arbeitsbereichszuordnungen rekursiv angewendet. Wenn Sie einen lokalen Ordner einem Ordner auf dem Server für die Team Foundation-Versionskontrolle zuordnen, werden im System implizit Zuordnungen zwischen allen aktuellen und zukünftigen Unterordnern erstellt. Wenn Sie z. B. $/projects dem Ordner c:\projects zuordnen, anschließend das Projekt $/projects/project_one hinzufügen und dann einen get-Vorgang für den Arbeitsbereich ausführen, erstellt Team Foundation automatisch einen lokalen Arbeitsordner mit der Bezeichnung project_one im Verzeichnis C:\projects.
In diesem Beispiel können Sie einen Platzhalter (*) verwenden, um dem lokalen Arbeitsbereich einen Serverordner mit den unmittelbar untergeordneten Elementen zuzuordnen.
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
In diesem Beispiel können Sie die automatisch erstellte Zuordnung zwischen $/projects/project_one und C:\projects\project_one folgendermaßen mithilfe des Befehls workfold überschreiben:
tf workfold $/projects/project_one C:\DifferentWorkfold
Zuordnungen unter Verdeckungen
Zuordnungen von nicht verdeckten Ordnern, die sich unter einem verdeckten Ordner in der Hierarchie der Versionskontrolle 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 Ordner $/projects/project_one auf dem Server für die Team Foundation-Versionskontrolle zugeordnet. Außerdem werden frühere Arbeitsbereichszuordnungen für den Ordner $/projects/project_one auf dem Server für die Team Foundation-Versionskontrolle ersetzt.
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold
Siehe auch
Aufgaben
Gewusst wie: Verdecken und Freilegen von Ordnern in einem Arbeitsbereich
Gewusst wie: Erstellen eines zugeordneten Arbeitsbereichs
Konzepte
Arbeiten mit Versionskontrollarbeitsbereichen
Referenz
Befehlszeilensyntax (Team System)