Arbeitsbereiche (Befehl "Team Foundation Version Control")
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022-
Der Befehl "Team Foundation Version Control" (TFVC) workspaces zeigt Informationen zu Arbeitsbereichen im System an und aktualisiert zwischengespeicherte Informationen zu einem Benutzernamen oder Computernamen auf einem Azure DevOps-Server.
Voraussetzungen
Wenn Sie den Befehl workspaces verwenden möchten, legen Sie die Berechtigung "Lesen" auf "zulassen" fest. 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 Befehls workspaces beschrieben.
Argumente
Argument
Beschreibung
<owner-name>
Stellt einen Wert für die Option /owner bereit. Verwenden Sie eine leere Zeichenfolge ("") zum Abgleichen von Arbeitsbereichen, die von einem beliebigen Benutzer erstellt wurden.
<computer-name>
Stellt einen Wert für die Option /computer bereit. Verwenden Sie eine leere Zeichenfolge ("") zum Abgleichen von Arbeitsbereichen auf einem beliebigen Computer.
<workspace-name>
Gibt den Namen eines Arbeitsbereichs an, zu dem Informationen angezeigt werden sollen. Wenn kein Wert angegeben ist, werden Informationen zu allen Arbeitsbereichen auf einem Server angezeigt. Sie können auch ein Sternchen (*) platzhalterzeichen verwenden, um Informationen zu allen Arbeitsbereichen für einen Server anzuzeigen.
<old-user-name>
Stellt den alten Benutzernamen für die Option /updateUserName bereit.
<old-computer-name>
Stellt den alten Computernamen für die Option /updateComputerName bereit.
<team-project-collection-url>
Die URL der Projektsammlung, die die Arbeitsbereiche enthält, zu denen Informationen angezeigt werden sollen, z. B. https://myserver:8080/tfs/DefaultCollection.
<username>
Stellt einen Wert für die Option /login bereit. Sie können diesen Wert entweder als DOMAIN\<username> oder als <username>angeben.
<password>
Stellt einen Wert für die Option /login bereit.
Optionen
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 option /collection angegeben wird.
Brief ist der Standardwert.
/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 mithilfe der Option /collection 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 Projektsammlung mithilfe der Option /collection 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 befehl workspaces des Befehlszeilenprogramms tf zeigt Informationen zu Arbeitsbereichen auf dem aktuellen Computer, im Besitz eines angegebenen Benutzers oder für alle Arbeitsbereiche an, 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 detaillierter Ausgabe werden auch die Arbeitsbereichszuordnungen angezeigt. Sofern Sie keinen Filter wie Besitzer, Computer oder Arbeitsbereichsnamen angeben, zeigt TFVC nur Informationen zu den von Ihnen erstellten Arbeitsbereichen an.
Weitere Informationen zum Bearbeiten von Arbeitsbereichseigenschaften finden Sie unter Arbeitsbereichsbefehl.
Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.
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 an 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 detaillierte Informationen zum Arbeitsbereich WS1angezeigt, die dem aktuellen Benutzer gehören und sich auf dem aktuellen Computer befinden. Die angezeigten Informationen enthalten eine Liste der 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 an der Adresse https://myserver:8080/tfs/DefaultCollectionentfernt:
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection