Befehl Workspaces

Zeigt Informationen über Arbeitsbereiche im System an und aktualisiert zwischengespeicherte Informationen bei Änderungen an Benutzer- oder Computernamen auf dem Server mit Visual Studio Team Foundation Server.

Erforderliche Berechtigungen

Zum Verwenden des workspaces-Befehls muss die Berechtigung Lesen auf Zulassen festgelegt sein. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.

tf workspaces [/owner:ownername] [/computer:computername] 
[/collection:TeamProjectCollectionUrl] [/format:(brief|detailed)] 
[/updateUserName:oldUserName] [/updateComputerName:oldComputerName] 
[workspacename][/login:username,[password]]

tf workspaces /remove:(*|workspace1[,workspace2,...]) 
/collection:(*|TeamProjectCollectionUrl)

Parameter

Argument

Beschreibung

ownername

Gibt einen Wert für die /owner-Option an. Geben Sie "*" an, um von beliebigen Benutzern erstellte Arbeitsbereiche zu verwenden.

computername

Gibt einen Wert für die /computer -Option an. Geben Sie "*" an, um Arbeitsbereiche auf allen Computern zu verwenden.

workspacename

Gibt den Namen eines Arbeitsbereichs an, über den Informationen angezeigt werden sollen. Wenn kein workspacename angegeben wird, werden Informationen über alle Arbeitsbereiche auf einem Server angezeigt. Sie können auch das Platzhalterzeichen "*" verwenden, um Informationen über alle Arbeitsbereiche für einen Server anzuzeigen.

oldUserName

Stellt den alten Benutzernamen für die /updateUserName-Option bereit.

oldComputerName

Stellt den alten Computernamen für die /updateComputerName-Option bereit.

TeamProjectCollectionUrl

Die URL der Teamprojektauflistung, die die Arbeitsbereiche enthält, zu denen Sie Informationen anzeigen 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

/owner

Gibt den Namen des Benutzers an, der den Arbeitsbereich erstellt hat. Wenn kein Besitzer angegeben wird, gibt Team Foundation nur über die Arbeitsbereiche Informationen zurück, die dem aktuellen Benutzer gehören.

/computer

Gibt den Namen eines Clientcomputers an, nach dem die Liste der Arbeitsbereiche für den Server gefiltert werden soll. Wenn kein Computer angegeben wird, gibt Team Foundation nur Informationen über Arbeitsbereiche auf dem aktuellen Computer zurück.

/format

Gibt das Format der Informationen über die Arbeitsbereiche an. Brief gibt diese Informationen ohne Zuordnungen an. Detailed gibt neben den Informationen für die Arbeitsbereiche auch die Zuordnungen an. Das ausführliche Format kann nur verwendet werden, wenn die Option /collection angegeben wird. Der Standardwert ist Brief.

/updateUserName

Aktualisiert die Sicherheitsinformationen auf dem Team Foundation-Server für einen Benutzer, dessen Netzwerkbenutzername geändert wurde. Wenn Sie diese Option angeben, müssen Sie mithilfe der Option /collection auch eine Teamprojektauflistung angeben.

/updateComputerName

Weist Team Foundation an, seine Tabellen nach einer Änderung am Namen eines Clientcomputers zu aktualisieren. Wenn Sie diese Option angeben, müssen Sie mithilfe der Option /collection auch eine Teamprojektauflistung angeben.

/remove

Entfernt die angegebenen Arbeitsbereichseinträge für die angegebene Teamprojektauflistung aus dem Clientcache.

/collection

Gibt die Teamprojektsammlung an.

/login

Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Team Foundation Server an.

Hinweise

Der Befehl workspaces des Befehlszeilentools tf zeigt Informationen über Arbeitsbereiche auf dem aktuellen Computer an, deren Besitzer ein angegebener Benutzer ist, oder für alle Arbeitsbereiche, die einem bestimmten Team Foundation Server zugeordnet sind. Team Foundation zeigt für jeden Arbeitsbereich Name, Besitzer, Kommentar und Computernamen an. Bei der ausführlichen Ausgabe werden auch die Arbeitsbereichszuordnungen angezeigt. Wenn Sie keinen Filter, z. B. Besitzer, Computer- oder Arbeitsbereichsname angeben, zeigt Team Foundation lediglich Informationen über die Arbeitsbereiche an, die Sie erstellt haben.

Weitere Informationen über das Bearbeiten von Eigenschaften von Arbeitsbereichen finden Sie unter Befehl Workspace.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".

Beispiele

Im folgenden Beispiel wird eine Liste aller Arbeitsbereiche für den aktuellen Benutzer auf dem aktuellen Computer angezeigt.

c:\projects>tf workspaces

Im folgenden Beispiel wird die Liste aller Arbeitsbereiche aller Benutzer auf allen Computern angezeigt, die in der folgenden Teamprojektauflistung unter der Adresse http://myserver:8080/tfs/DefaultCollection/ erstellt wurden.

c:\projects>tf workspaces /owner:* /computer:* /collection:http://myserver:8080/tfs/DefaultCollection

Im folgenden Beispiel werden ausführliche Informationen zu allen Arbeitsbereichen angezeigt, die der aktuelle Benutzer in der Teamprojektauflistung unter der Adresse http://myserver:8080/tfs/DefaultCollection erstellt hat.

c:\projects>tf workspaces /computer:* /format:detailed /collection:http://myserver:8080/tfs/DefaultCollection

Im folgenden Beispiel werden ausführliche Informationen, einschließlich einer Liste der Arbeitsbereichszuordnungen, für den Arbeitsbereich "WS1" angezeigt, dessen Besitzer der aktuelle Benutzer ist, und der sich auf dem aktuellen Computer befindet.

c:\projects>tf workspaces /format:detailed /collection:http://myserver:8080/tfs/DefaultCollection WS1

Im folgenden Beispiel werden alle zwischengespeicherte Arbeitsbereiche aus dem Cache in der Teamprojektauflistung unter der Adresse http://myserver:8080/tfs/DefaultCollection entfernt.

c:\projects>tf workspaces /remove:* /collection:http://myserver:8080/tfs/DefaultCollection

Siehe auch

Aufgaben

Erstellen eines Arbeitsbereichs und Abrufen von Dateien

Referenz

Befehlszeilensyntax (Versionskontrolle)

Befehl Workspace

Befehl Workfold

Konzepte

Erstellen eines Arbeitsbereichs zum Arbeiten mit dem Teamprojekt

Weitere Ressourcen

Befehle des Befehlszeilenhilfsprogramms "Tf"