Befehl Workspace
Ermöglicht das Erstellen, Löschen, Anzeigen und Ändern der Eigenschaften und Zuordnungen eines Arbeitsbereichs.
Erforderliche Berechtigungen
Zum Ändern oder Löschen eines vorhandenen Arbeitsbereichs müssen Sie entweder Besitzer des Arbeitsbereichs sein, oder die globale Berechtigung Arbeitsbereiche verwalten muss auf Zulassen festgelegt sein. Zum Erstellen eines Arbeitsbereichs muss die globale Berechtigung Arbeitsbereich erstellen auf Zulassen festgelegt sein. Um Arbeitsbereiche für andere Benutzer zu erstellen, muss die Berechtigung Arbeitsbereiche verwalten auf Zulassen festgelegt sein. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.
tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
[/computer:computername] [/comment:("comment"|@comment file)]
[/collection:TeamProjectCollectionUrl] [/permission:(Private|PublicLimited|Public)][workspacename[;workspaceowner]][/login:username,[password]]
tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner][/login:username,[password]]
tf workspace [/collection:TeamProjectCollectionUrl] [/comment: ("comment"|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]] [/newowner:ownername] [/computer:computername] [/permission:(Private|PublicLimited|Public)] [/login:username,[password]]
Parameter
Argument |
Beschreibungen |
|---|---|
workspacename |
Gibt einen Namen für den Arbeitsbereich an, der erstellt, bearbeitet oder gelöscht werden soll oder zu dem Informationen angezeigt werden sollen. |
workspaceowner |
Gibt einen Benutzernamen für den Arbeitsbereich an. Dieser Parameter ist erforderlich, wenn der Besitzer des Arbeitsbereichs nicht die Person ist, die den Befehl ausführt. |
computername |
Gibt einen Wert für die /computer -Option an. |
comment |
Gibt einen Wert für die /comment -Option an. |
@commentfile |
Gibt den Pfad von einer Datei an, aus der der Kommentar gelesen werden soll. |
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. |
TeamProjectCollectionUrl |
Die URL der Teamprojektauflistung, die den Arbeitsbereich enthält, für den Sie Informationen erstellen, bearbeiten, löschen oder anzeigen möchten (z. B. http://myserver:8080/tfs/DefaultCollection). |
ownername |
Gibt einen Wert für die /newowner -Option an. |
Option |
Beschreibungen |
|---|---|
/new |
Erstellt einen neuen Arbeitsbereich. |
/template |
Gibt einen vorhandenen Arbeitsbereich an, der als Vorlage für das Erstellen des neuen Arbeitsbereichs verwendet werden soll. Der neue Arbeitsbereich verwendet die Zuordnungen des vorhandenen Arbeitsbereichs. |
/delete |
Löscht den angegebenen Arbeitsbereich. |
/computer |
Gibt den Namen des Computers an, auf dem der Arbeitsbereich erstellt werden soll. Diese Option ist eine erweiterte Option. |
/comment |
Stellt einen Kommentar bereit, der den Arbeitsbereich beschreibt. |
/newname |
Benennt einen vorhandenen Arbeitsbereich um. |
/noprompt |
Führt den angegebenen Arbeitsbereichsbefehl aus, ohne ein Dialogfeld anzuzeigen. |
/collection |
Gibt die Teamprojektsammlung an. |
/permission |
Gibt die Optionen der Arbeitsbereichsberechtigung an:
|
/login |
Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an. |
/newowner |
Gibt den Benutzernamen für den neuen Besitzer des Arbeitsbereichs an. |
Hinweise
Ein Arbeitsbereich ist eine lokale Kopie der Dateien und Ordner auf dem Server sowie aller lokal vorgenommenen Änderungen. Wenn Sie ein Element, das der Versionskontrolle unterliegt, hinzufügen, bearbeiten, löschen, verschieben, umbenennen oder auf andere Weise ändern, werden die Änderungen in Ihrem Arbeitsbereich isoliert, in dem Sie Änderungen vornehmen und testen können. Für Ihre ausstehenden Änderungen wird auf dem Server ein Commit ausgeführt, sodass diese für Benutzer außerhalb Ihres Arbeitsbereichs verfügbar werden, wenn Sie sie einchecken.
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".
Erstellen eines Arbeitsbereichs
Bevor Sie Dateien auf dem Versionskontrollserver hinzufügen oder Elemente auf dem Server auschecken, um sie zu bearbeiten, müssen Sie einen Arbeitsbereich erstellen oder dem aktuellen Verzeichnis einen vorhandenen Arbeitsbereich zuordnen. Weitere Informationen finden Sie unter Erstellen eines Arbeitsbereichs und Abrufen von Dateien.
Um das aktuelle Verzeichnis als Arbeitsordner für einen vorhandenen Arbeitsbereich auf dem Computer festzulegen, geben Sie tf workspace workspacename ein, wobei workspacename der Name des vorhandenen Arbeitsbereichs ist. Das Dialogfeld Arbeitsbereich bearbeiten wird angezeigt. Klicken Sie auf Klicken Sie hier, um einen neuen Arbeitsordner einzugeben, geben Sie im Feld Quellcodeverwaltungsordner den Serverpfad, dem Sie das aktuelle Verzeichnis zuordnen möchten, und im Feld Lokaler Ordner das aktuelle Verzeichnis ein, und klicken Sie auf OK.
Wenn Sie einen neuen Arbeitsbereich erstellen, können Sie einen Vorlagenarbeitsbereich als Teil der Option /new angeben. Wenn Sie einen Vorlagenarbeitsbereich angeben, erstellt Team Foundation einen neuen Arbeitsbereich auf dem aktuellen Computer, legt als Besitzer den aktuellen Besitzer fest und repliziert die folgenden Arbeitsbereichseigenschaften aus dem Vorlagenarbeitsbereich in den neuen Arbeitsbereich: Zuordnungen und Kommentar. Wenn kein Name angegeben ist, verwendet das System einen Namen, der auf dem aktuellen Computernamen basiert. Wenn Sie einen Arbeitsbereich mithilfe einer Vorlage erstellen, ruft Team Foundation nicht die zugeordneten Dateien vom Server ab. Verwenden Sie den Befehl Get, um den neuen Arbeitsbereich mit der letzten Version auf dem Server zu synchronisieren.
Zuordnung einzelner Ordner
Sie können einem lokalen Arbeitsbereich auch nur die unmittelbar untergeordneten Elemente eines Ordners der Versionskontrolle zuordnen. Fügen Sie dazu ein Sternchen als Platzhalterzeichen im Dialogfeld Arbeitsbereich hinzufügen im Feld Quellcodeverwaltungsordner hinzu. Zum Beispiel: $/folder/*. Andernfalls werden standardmäßig alle untergeordneten Elemente des Ordners der Versionskontrolle dem lokalen Arbeitsbereich rekursiv zugeordnet.
Die Zuordnung einzelner Ordner innerhalb einer Versionskontrollhierarchie ist hilfreich, da damit die Anzahl der auf den Clientcomputer heruntergeladenen Elemente beschränkt wird. Sie haben auch die Möglichkeit, die Dateien zu verdecken, die Sie nicht im Arbeitsbereich benötigen, um die heruntergeladenen Dateien zu beschränken. Weitere Informationen finden Sie unter Verdecken und Freilegen von Ordnern in einem Arbeitsbereich. Das sorgt für ein schnelleres Herunterladen und spart Speicherplatz auf dem Clientcomputer.
Löschen eines Arbeitsbereichs
Wenn Sie einen Arbeitsbereich mit ausstehenden Änderungen löschen, verwirft Team Foundation diese beim Löschvorgang. Beim Löschen eines Arbeitsbereichs werden keine Dateien oder Ordner auf dem Clientcomputer gelöscht, die zu dem Arbeitsbereich gehörten.
Bearbeiten eines Arbeitsbereichs
Die folgenden Arbeitsbereichsattribute können geändert werden:
Arbeitsbereichsname
Kommentar
Arbeitsordnerzuordnungen
Wenn keine Arbeitsbereichsspezifikation angegeben wird, wird der Arbeitsbereich für den aktuellen Ordner verwendet.
Beispiele
Im folgenden Beispiel wird das Dialogfeld Arbeitsbereich hinzufügen geöffnet und ein neuer Arbeitsbereich erstellt. Sie können das Dialogfeld Arbeitsbereich hinzufügen verwenden, um den Quellcodeverwaltungsordner, den Eigentümer, den Computer, den Kommentar und lokale Ordner zu bearbeiten.
c:\projects>tf workspace /new /collection:http://myserver:8080/tfs/DefaultCollection
Im folgenden Beispiel wird ein neuer Arbeitsbereich mit der Bezeichnung Beta1 erstellt, dem als Besitzer jenh zugeordnet wird. Sie müssen über die Berechtigung AdminWorkspaces verfügen, um einem anderen Benutzer den Besitz eines neuen Arbeitsbereichs zuzuweisen. Weitere Informationen über Sicherheitsberechtigungen finden Sie unter Team Foundation Server-Berechtigungen.
c:\projects>tf workspace /new Beta1;jenh
Im folgenden Beispiel wird ein neuer Arbeitsbereich unter Verwendung des Arbeitsbereichs Beta1 als Vorlage erstellt, deren Besitzer jenh ist.
c:\projects>tf workspace /new /template:Beta1;jenh /collection:http://myserver:8080/tfs/DefaultCollection
Im folgenden Beispiel wird der Arbeitsbereich Beta1 vom Server entfernt.
c:\projects>tf workspace /delete Beta1
Im folgenden Beispiel werden Eigenschaften des aktuellen Arbeitsbereichs bearbeitet.
c:\projects>tf workspace
Im folgenden Beispiel wird der Arbeitsbereich Beta1 geöffnet, dessen Besitzer jenh ist, sodass Sie die Eigenschaften und Zuordnungen anzeigen können. Wenn Sie über die Berechtigung AdminWorkspaces verfügen, können Sie die Eigenschaften und Zuordnungen des Arbeitsbereichs ändern.
c:\projects> tf workspace Beta1;jenh
Siehe auch
Aufgaben
Erstellen eines Arbeitsbereichs und Abrufen von Dateien
Verdecken und Freilegen von Ordnern in einem Arbeitsbereich
Referenz
Befehlszeilensyntax (Versionskontrolle)
Konzepte
Erstellen eines Arbeitsbereichs zum Arbeiten mit dem Teamprojekt