Befehl Workfold
Erstellt Informationen über die Zuordnungen zwischen den Arbeitsbereichsordnern und den Ordnern auf dem Server für die Quellcodeverwaltung in Team Foundation bzw. ändert diese oder zeigt sie an.
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 (Team Foundation source control
serverfolder|localfolder) [/workspace: workspacename] [/s:servername]
tf workfold /decloak (serverfolder|localfolder)
[/workspace: workspacename] [/s:servername]
Parameter
| Argument | Beschreibung |
|---|---|
servername |
Der vom Benutzer angegebene Wert für die /server-Option. Beispiel: teamfoundation2. |
workspacename |
Der vom Benutzer angegebene Wert für die /workspace-Option. |
serverfolder |
Gibt den Namen eines Ordners auf dem Server für die Quellcodeverwaltung in Team Foundation 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 Quellcodeverwaltung in Team Foundation an. Standardmäßig verwendet der Befehl workfold diese Option auch wenn sie nicht angegeben wird, sofern nicht /unmap, /cloak oder or /decloak angegeben wird. |
/unmap |
Gibt an, dass die angegebene Ordnerzuordnung gelöscht werden soll. |
/cloak |
Gibt an, dass der Ordner von der Arbeitsbereichsansicht 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 tf Arbeitsbereichszuordnungen erstellen und bearbeiten. Eine Arbeitsbereichszuordnung erstellt einen clientseitigen Ordner, in dem alle Dateien und Unterordner im Quellcodeverwaltung in Team Foundation-Serverordner abgerufen werden, wenn Sie einen tf get-Vorgang durchführen. Dazu darf der Ordner auf dem Client nicht verdeckt sein.
Optionen für Arbeitsbereichszuordnung
Eine Arbeitsbereichszuordnung ist eine Liste von zugeordneten und verdeckten Elemente. Sie können Elemente des Servers für die Quellcodeverwaltung in Team Foundation 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 Elemente verdecken, denen ein übergeordnetes Element zugeordnet ist. Durch Verdecken kann man die Geschwindigkeit von Get-Stapelvorgängen erhöhen und Speicherplatz auf dem Datenträger einsparen, die Verwendung sollte allerdings mit Umsicht erfolgen. 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 Ordner einem Ordner auf dem Server für die Quellcodeverwaltung in Team Foundation zuordnen, werden 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 den Arbeitsbereich abrufen, erstellt Team Foundation automatisch einen lokalen Arbeitsordner mit der Bezeichnung project_one im Verzeichnis C:\projects.
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
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 Stamm des Servers für die Quellcodeverwaltung in Team Foundation dem aktuellen Verzeichnis zugeordnet.
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 Quellcodeverwaltung in Team Foundation zugeordnet. Außerdem werden frühere Arbeitsbereichszuordnungen für den Ordner $/projects/project_one auf dem Server für die Quellcodeverwaltung in Team Foundation gelöscht.
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold
Sicherheit
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.
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Quellcodeverwaltung über die Befehlszeile
Gewusst wie: Verdecken und Freilegen von Ordnern in einem Arbeitsbereich
Referenz
Befehlszeilensyntax
Befehl Workspace
Konzepte
Arbeiten mit Arbeitsbereichen der Quellcodeverwaltung