Befehl Workfold
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 hierzu finden Sie unter Team Foundation Server-Berechtigungen.
tf workfold localfolder [/login:username,[password]]
tf workfold [/workspace:workspacename] [/login:username,[password]]
tf workfold [/collection:TeamProjectCollectionUrl] [/workspace:workspacename] [/login:username,[password]]
serverfolder
tf workfold [/map serverfolder localfolder] [/collection:TeamProjectCollectionUrl]
[/workspace:workspacename][/login:username,[password]
tf workfold /unmap [/collection:TeamProjectCollectionUrl] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder) [/login:username,[password]]
tf workfold /cloak
serverfolder [/workspace:workspacename] [/collection:TeamProjectCollectionUrl] [/login:username,[password]]
tf workfold /decloak serverfolder
[/workspace:workspacename] [/collection:TeamProjectCollectionUrl][/login:username,[password]]
Parameter
Argument |
Beschreibungen |
|---|---|
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. |
TeamProjectCollectionUrl |
Die URL der Teamprojektauflistung, die die Ordner enthält, die Sie mit Serverordnern vergleichen möchten (z. B. http://myserver:8080/tfs/DefaultCollection/). |
username |
Gibt einen Wert für die /login-Option an. Sie können als Wert für einen Benutzernamen entweder DOMÄNE\Benutzername oder Benutzername angeben. |
Option |
Beschreibungen |
|---|---|
/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. |
/collection |
Gibt die Teamprojektsammlung an. |
/login |
Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an. |
Hinweise
Sie können mit dem Befehl workfold des Befehlszeilenprogramms tf Arbeitsbereichszuordnungen 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 tf get-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 Befehlszeilenhilfsprogramms "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
Verdecken und Freilegen von Ordnern in einem Arbeitsbereich
Erstellen eines Arbeitsbereichs und Abrufen von Dateien
Referenz
Befehlszeilensyntax (Versionskontrolle)
Konzepte
Erstellen eines Arbeitsbereichs zum Arbeiten mit dem Teamprojekt