Arbeitsbereichsbefehl (Team Foundation-Versionskontrolle)
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018
Visual Studio 2019 | Visual Studio 2022
Der befehl Team Foundation-Versionskontrolle (TFVC) workspaces zeigt Informationen zu Arbeitsbereichen im System an und aktualisiert zwischengespeicherte Informationen zu einer Änderung des Benutzernamens oder Des Computernamens auf einem Azure DevOps-Server.
Voraussetzungen
Um den workspaces Befehl verwenden zu können, muss die Berechtigung Lesen auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.
Syntax
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
Parameter
In den folgenden Abschnitten werden Argumente und Optionen des workspaces Befehls beschrieben.
Argumente
Argument
Beschreibung
<owner-name>
Stellt der Option einen Wert bereit /owner . Verwenden Sie eine leere Zeichenfolge (""), um arbeitsbereiche abzugleichen, die von einem beliebigen Benutzer erstellt wurden.
<computer-name>
Stellt der Option einen Wert bereit /computer . Verwenden Sie eine leere Zeichenfolge (""), um Arbeitsbereiche auf einem beliebigen Computer abzugleichen.
<workspace-name>
Gibt den Namen eines Arbeitsbereichs an, zu dem Informationen angezeigt werden sollen. Wenn kein Wert angegeben wird, werden Informationen zu allen Arbeitsbereichen auf einem Server angezeigt. Sie können auch ein Platzhalterzeichen (*) verwenden, um Informationen zu allen Arbeitsbereichen für einen Server anzuzeigen.
<old-user-name>
Stellt den alten Benutzernamen für die Option bereit /updateUserName .
<old-computer-name>
Stellt den alten Computernamen für die Option bereit /updateComputerName .
<team-project-collection-url>
Die URL der Projektsammlung, die die Arbeitsbereiche enthält, zu denen Sie Informationen anzeigen möchten, z. B https://myserver:8080/tfs/DefaultCollection. .
<username>
Stellt der Option einen Wert bereit /login . Sie können diesen Wert als oder DOMAIN\<username><username>angeben.
<password>
Stellt der Option einen Wert bereit /login .
Tastatur
Option
Beschreibung
/owner
Gibt den Namen des Benutzers an, der den Arbeitsbereich erstellt hat. Wenn kein Besitzer angegeben ist, gibt TFVC nur Informationen zu Arbeitsbereichen 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 ist, gibt TFVC nur Informationen zu Arbeitsbereichen auf dem aktuellen Computer zurück.
/format
Gibt das Format der Arbeitsbereichsinformationen an. Brief gibt Arbeitsbereichsinformationen ohne Zuordnungen zurück. Detailed gibt Arbeitsbereichsinformationen und auch die Zuordnungen zurück. Xml gibt Arbeitsbereichsinformationen, eine Zuordnung, das neueste Zugriffsdatum und auch die Besitzeralias zurück. Das detaillierte Format kann nur verwendet werden, wenn die /collection Option angegeben ist. Der Standardwert lautet Brief.
/updateUserName
Aktualisierungen Sicherheitsidentifikationsinformationen auf dem Azure DevOps-Server für einen Benutzer, dessen Netzwerkbenutzername geändert wurde. Wenn Sie diese Option angeben, müssen Sie auch eine Projektauflistung mit der /collection Option angeben.
/updateComputerName
Weist TFVC an, seine Tabellen zu aktualisieren, um eine Änderung des Namens eines Clientcomputers widerzuspiegeln. Wenn Sie diese Option angeben, müssen Sie auch eine Projektauflistung mit der /collection Option angeben.
/remove
Entfernt die angegebenen Arbeitsbereichseinträge für die angegebene Projektsammlung aus dem Clientcache.
/collection
Gibt die Projektauflistung an.
/login
Gibt den Benutzernamen und das Kennwort an, um den Benutzer mit Azure DevOps Server zu authentifizieren.
Bemerkungen
Der workspaces Befehl des tf Befehlszeilenprogramms zeigt Informationen zu Arbeitsbereichen auf dem aktuellen Computer an, der einem angegebenen Benutzer gehört, oder für alle Arbeitsbereiche, die einem bestimmten Azure DevOps-Server zugeordnet sind. Für jeden Arbeitsbereich zeigt TFVC den Namen, den Besitzer, den Kommentar und den Computernamen an. Mit der detaillierten Ausgabe werden auch die Arbeitsbereichszuordnungen angezeigt. Sofern Sie keinen Filter wie Besitzer, Computer oder Arbeitsbereichsname angeben, zeigt TFVC nur Informationen zu den arbeitsbereichen an, die Sie erstellt haben.
Weitere Informationen zum Bearbeiten von Arbeitsbereichseigenschaften finden Sie unter Arbeitsbereichsbefehl.
Weitere Informationen zur Verwendung des Befehlszeilenprogramms finden Sie unter Verwenden vontf Team Foundation-Versionssteuerungsbefehlen.
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 eine Liste aller Arbeitsbereiche für alle Benutzer auf allen Computern angezeigt, die in der folgenden Projektsammlung unter der Adresse https://myserver:8080/tfs/DefaultCollectionerstellt wurden:
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
Im folgenden Beispiel werden detaillierte Informationen zu allen Arbeitsbereichen angezeigt, die der aktuelle Benutzer in der Projektsammlung unter der Adresse https://myserver:8080/tfs/DefaultCollectionerstellt hat:
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
Im folgenden Beispiel werden ausführliche Informationen zum Arbeitsbereich WS1 angezeigt, der sich im Besitz des aktuellen Benutzers befindet und sich auf dem aktuellen Computer befindet. Die angezeigten Informationen enthalten eine Liste von Arbeitsbereichszuordnungen.
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
Im folgenden Beispiel werden alle zwischengespeicherten Arbeitsbereiche aus dem Cache in der Projektsammlung unter der Adresse https://myserver:8080/tfs/DefaultCollectionentfernt:
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection