Befehl Workspace
Ermöglicht das Erstellen, Löschen, Anzeigen und Ändern der Eigenschaften und Zuordnungen eines Arbeitsbereichs.
tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
[/computer:computername] [/comment:(“comment”|@comment file)]
[/s:servername] [workspacename[;workspaceowner]]
tf workspace /delete [/server:servername] workspacename[;workspaceowner]
tf workspace [/server:servername] [/comment:comment] [/newname:workspacename]
[workspacename[;workspaceowner]]
Parameter
| Argument | Beschreibung |
|---|---|
workspacename |
Gibt einen Namen für den Arbeitsbereich an, der erstellt, bearbeitet oder gelöscht werden soll oder über den Informationen angezeigt werden sollen. |
workspaceowner |
Gibt einen Benutzernamen für den Arbeitsbereich an. Dieser Parameter ist nur 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. |
servername |
Der vom Benutzer angegebene Wert für die /server-Option. Beispiel: teamfoundation2. |
| Option | Beschreibung |
|---|---|
/new |
Erstellt einen neuen Arbeitsbereich. |
/template |
Gibt einen vorhandenen Arbeitsbereich an, der als Vorlage für das Erstellen des neuen Arbeitsbereichs verwendet werden soll. Die Zuordnungen des vorhandenen Arbeitsbereichs werden auch im neuen Arbeitsbereich verwendet. |
/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. |
/server |
Identifiziert den Team Foundation Server. Diese Option ist erforderlich, wenn Sie einen neuen Arbeitsbereich erstellen und den Befehl workspace aus einem Verzeichnis aufrufen möchten, das keinem Arbeitsbereich zugeordnet ist. |
/newname |
Benennt einen vorhandenen Arbeitsbereich um. |
/noprompt |
Führt den angegebenen Arbeitsbereichsbefehl aus, ohne ein Dialogfeld anzuzeigen. |
Hinweise
Ein Arbeitsbereich ist eine lokale Kopie der Dateien und Ordner auf dem Server sowie aller lokal vorgenommenen Änderungen. Wenn Sie ein Element unter Quellcodeverwaltung hinzufügen, bearbeiten, löschen, verschieben, umbenennen oder auf andere Weise ändern, gelten Ihre Änderungen nicht in Ihrem Arbeitsbereich, 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.
Erstellen eines neuen Arbeitsbereichs.
Bevor Sie Dateien auf dem Quellcodeverwaltungsserver hinzufügen oder Elemente auf dem Server auschecken, um diese zu bearbeiten, müssen Sie einen Arbeitsbereich erstellen oder dem aktuellen Verzeichnis einen Arbeitsbereich zuordnen. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Arbeitsbereichs.
Wenn Sie das aktuelle Verzeichnis als Arbeitsordner für einen vorhandenen Arbeitsbereich auf dem Computer festlegen möchten, geben Sie tf workspace ** workspacename ein, wobei workspacename der Name des vorhandenen Arbeitsbereichs ist. Klicken Sie anschließend auf Klicken Sie hier, um einen neuen Arbeitsordner einzugeben, geben Sie den Serverpfad, dem Sie das aktuelle Verzeichnis zuordnen möchten, im Feld Quellcodeverwaltungs-Serverordner von Team Foundation und das aktuelle Verzeichnis im Feld Lokaler Ordner ein, und klicken Sie dann 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 wird, wird ein auf dem aktuellen Computernamen basierender Name verwendet. 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.
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 erstellen geöffnet und ein neuer Arbeitsbereich erstellt.
c:\projects>tf workspace /new /server:teamserver2
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 /server:teamserver2
Im folgenden Beispiel wird der Arbeitsbereich Beta1 aus dem System 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
Sicherheit
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 finden Sie unter Team Foundation Server-Berechtigungen.
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Quellcodeverwaltung über die Befehlszeile
Gewusst wie: Erstellen eines Arbeitsbereichs
Gewusst wie: Verdecken und Freilegen von Ordnern in einem Arbeitsbereich
Referenz
Befehlszeilensyntax
Befehl Workspaces
Konzepte
Arbeiten mit Arbeitsbereichen der Quellcodeverwaltung