Workspaces-Befehl (Team Foundation-Versionskontrolle)
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Der workspaces-Befehl der Team Foundation-Versionskontrolle (TFVC) 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 zu verwenden, müssen Sie die Leseberechtigung auf Zulassen festlegen. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.
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 einen Wert für die /owner-Option bereit. Verwenden Sie eine leere Zeichenfolge („“), um Arbeitsbereiche abzugleichen, die von einem beliebigen Benutzer erstellt wurden.
<computer-name>
Stellt einen Wert für die /computer-Option bereit. Verwenden Sie eine leere Zeichenfolge („“), um Arbeitsbereiche abzugleichen, die auf einem beliebigen Computer erstellt wurden.
<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 das Platzhalterzeichen Sternchen (*) verwenden, um Informationen zu allen Arbeitsbereichen für einen Server anzuzeigen.
<old-user-name>
Stellt den alten Benutzernamen für die /updateUserName-Option bereit.
<old-computer-name>
Stellt den alten Computernamen für die /updateComputerName-Option bereit.
<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 einen Wert für die /login-Option bereit. Sie können diesen Wert als DOMAIN\<username> oder <username> angeben.
<password>
Stellt einen Wert für die Option /login bereit.
Tastatur
Option
Beschreibung
/owner
Gibt den Namen des Benutzers an, der den Arbeitsbereich erstellt hat. Wenn kein Besitzer angegeben wird, gibt TFVC nur Informationen zu Arbeitsbereichen zurück, die sich im Besitz des aktuellen Benutzers befinden.
/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 TFVC nur Informationen zu Arbeitsbereichen auf dem aktuellen Computer zurück.
/format
Gibt das Format der Arbeitsbereichinformationen an. Brief gibt Arbeitsbereichinformationen ohne Zuordnungen zurück. Detailed gibt Arbeitsbereichinformationen sowie die Zuordnungen zurück. Xml gibt Arbeitsbereichinformationen, eine Zuordnung, das neueste Zugriffsdatum und auch die Besitzeraliase zurück. Das detaillierte Format kann nur verwendet werden, wenn die /collection-Option angegeben wird. Der Standardwert lautet Brief.
/updateUserName
Aktualisiert 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 Projektsammlung mit der /collection-Option angeben.
/updateComputerName
Weist TFVC an, die Tabellen zu aktualisieren, um eine Änderung des Namens eines Clientcomputers widerzuspiegeln. Wenn Sie diese Option angeben, müssen Sie auch eine Projektsammlung mit der /collection-Option angeben.
/remove
Entfernt die angegebenen Arbeitsbereicheinträge für die angegebene Projektsammlung aus dem Clientcache.
/collection
Gibt die Projektsammlung an.
/login
Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps Server zu authentifizieren.
Hinweise
Der workspaces-Befehl des Befehlszeilenprogramms tf zeigt Informationen zu Arbeitsbereichen auf dem aktuellen Computer an, die einem angegebenen Benutzer gehören, 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 Arbeitsbereichzuordnungen angezeigt. Sofern Sie keinen Filter wie Besitzer-, Computer- oder Arbeitsbereichname angeben, zeigt TFVC nur Informationen zu den Arbeitsbereichen an, die Sie erstellt haben.
Weitere Informationen zum Bearbeiten von Arbeitsbereicheigenschaften finden Sie unter Workspace-Befehl.
Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.
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/DefaultCollection erstellt 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/DefaultCollection erstellt hat:
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
Im folgenden Beispiel werden detaillierte Informationen zum Arbeitsbereich WS1 angezeigt, der sich im Besitz des aktuellen Benutzers und auf dem aktuellen Computer befindet. Die angezeigten Informationen umfassen eine Liste von Arbeitsbereichzuordnungen.
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/DefaultCollection entfernt:
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection