Freigeben über

Arbeitsbereichsbefehl (Team Foundation Version Control)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022-

Der Befehl "Team Foundation Version Control" (TFVC) workspace bietet eine Möglichkeit zum Erstellen, Löschen, Anzeigen oder Ändern von Eigenschaften und Zuordnungen, die einem Arbeitsbereich zugeordnet sind.

Voraussetzungen

  • Um einen vorhandenen Arbeitsbereich zu ändern oder zu löschen, müssen Sie der Besitzer sein oder den globalen Arbeitsbereiche verwalten Berechtigung auf Zulassenfestlegen.
  • Zum Erstellen eines Arbeitsbereichs müssen Sie die globale "Arbeitsbereich erstellen" Berechtigungssatz auf Zulassen vonfestlegen.
  • Um Arbeitsbereiche für andere Benutzer zu erstellen, verfügen Sie über die Verwalten von Arbeitsbereichen Berechtigung auf Zulassenfestgelegt.

Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.

Syntax

tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]

tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]

tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]

Parameter

In den folgenden Abschnitten werden Argumente und Optionen des Befehls workspace beschrieben.

Argumente

Argument Beschreibung
<workspace-name> Gibt einen Namen für den Arbeitsbereich an, zu dem Sie Informationen erstellen, bearbeiten, löschen oder anzeigen möchten.
<workspace-owner> Gibt einen Benutzernamen für den Arbeitsbereich an. Dieser Parameter ist erforderlich, wenn der Arbeitsbereichsbesitzer nicht die Person ist, die den Befehl ausführt.
<computer-name> Stellt einen Wert für die Option /computer bereit.
<comment> Stellt einen Wert für die Option /comment bereit.
@<comment-file> Gibt den Pfad einer Datei an, in der der Kommentar gelesen werden soll.
<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.
<team-project-collection-url> Die URL der Projektsammlung, die den Arbeitsbereich enthält, den Sie erstellen, bearbeiten, löschen oder anzeigen möchten, z. B. zu https://myserver:8080/tfs/DefaultCollection.
<owner-name> Stellt einen Wert für die Option /newowner bereit.

Optionen

Option Beschreibung
/new Erstellt einen neuen Arbeitsbereich.
/template Gibt einen vorhandenen Arbeitsbereich an, der als Vorlage zum Erstellen eines neuen Arbeitsbereichs verwendet werden soll. Der neue Arbeitsbereich verwendet die Zuordnungen des vorhandenen Arbeitsbereichs.
/delete Löscht den angegebenen Arbeitsbereich.
/computer Gibt den Namen des Computers an, auf dem ein Arbeitsbereich erstellt werden soll. Diese Option ist eine erweiterte Option.
/comment Stellt einen Kommentar bereit, der den Arbeitsbereich beschreibt.
/newname Benennt einen vorhandenen Arbeitsbereich um.
/noprompt Führt den angegebenen Arbeitsbereichsbefehl aus, ohne ein Dialogfeld anzuzeigen.
/collection Gibt die Projektauflistung an.
/permission Gibt die Optionen für Arbeitsbereichsberechtigungen an:

    - Private: Nur die Besitzer können Dateien verwenden, einchecken oder den Arbeitsbereich verwalten.


    - Public Limited: Jeder gültige Benutzer kann den Arbeitsbereich verwenden. Aber nur die Besitzer können Dateien einchecken oder den Arbeitsbereich verwalten.


    - Public: Jeder gültige Benutzer kann dateien verwenden, einchecken oder den Arbeitsbereich verwalten.
/location Gibt an, wo der Arbeitsbereich erstellt wird:

    - local: Auf dem Clientcomputer. Dieser Wert ist der Standardwert.


    - server: Auf dem Azure DevOps-Server.
/login Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.
/newowner Gibt den Benutzernamen für den neuen Besitzer des Arbeitsbereichs an.

Bemerkungen

Ein Arbeitsbereich ist eine lokale Kopie der Dateien und Ordner auf dem Server sowie alle Änderungen, die Sie lokal vorgenommen haben. Wenn Sie elemente hinzufügen, bearbeiten, löschen, verschieben, umbenennen oder anderweitig ändern, sind Ihre Änderungen in Ihrem Arbeitsbereich isoliert, wo Sie Ihre Änderungen vornehmen und testen können. Wenn Sie Ihre Arbeit an der Codebasis des Teamseinchecken , übernehmen Sie die Änderungen auf dem Server. Sie werden für andere Benutzer verfügbar, die sich außerhalb Ihres Arbeitsbereichs befinden.

Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.

Erstellen eines Arbeitsbereichs

Bevor Sie dem Versionssteuerungsserver Dateien hinzufügen oder Elemente auf dem Server auschecken können, müssen Sie einen Arbeitsbereich erstellen oder dem aktuellen Verzeichnis ein vorhandenes zuordnen. Weitere Informationen finden Sie unter Einrichten der Team Foundation-Versionssteuerung auf Ihrem Entwicklungscomputer.

Führen Sie die folgenden Schritte aus, um das aktuelle Verzeichnis zu einem Arbeitsordner für einen vorhandenen Arbeitsbereich auf Ihrem Computer zu machen:

  1. Geben Sie tf workspace <workspace-name>ein, wobei <workspace-name> der Name des vorhandenen Arbeitsbereichs ist. Das Dialogfeld Arbeitsbereich bearbeiten wird angezeigt.
  2. Wählen Sie klicken Sie hier, um einen neuen Arbeitsordnereinzugeben.
  3. Geben Sie im Feld Ordner für die Quellcodeverwaltung den Serverpfad ein, dem Sie das aktuelle Verzeichnis zuordnen möchten.
  4. Geben Sie im Feld lokalen Ordner das aktuelle Verzeichnis ein.
  5. Wählen Sie OKaus.

Wenn Sie einen neuen Arbeitsbereich erstellen, können Sie einen Vorlagenarbeitsbereich als Teil der Option /new angeben. Wenn Sie einen Vorlagenarbeitsbereich angeben, erstellt TFVC einen neuen Arbeitsbereich auf dem aktuellen Computer. TFVC legt außerdem den Besitzer auf den aktuellen Besitzer fest und repliziert die folgenden Arbeitsbereichseigenschaften in den neuen Arbeitsbereich aus dem Vorlagenarbeitsbereich: mappings und comment. Wenn kein Name angegeben ist, verwendet das System einen Namen, der auf dem aktuellen Computernamen basiert. Wenn Sie einen Arbeitsbereich mithilfe einer Vorlage erstellen, ruft TFVC nicht die Dateien ab, denen er vom Server zugeordnet ist. Verwenden Sie den Befehl get, um den neuen Arbeitsbereich mit der neuesten Version auf dem Server zu synchronisieren. Weitere Informationen finden Sie unter Befehl abrufen.

Zuordnung einzelner Ordner

Sie können auswählen, dass nur die unmittelbaren untergeordneten Elemente eines Versionssteuerungsordners einem lokalen Arbeitsbereich zugeordnet werden sollen. Fügen Sie dazu im Dialogfeld Dialogfeld " Arbeitsbereich hinzufügen" ein Sternchen (*) platzhalterzeichen im Feld Quellcodeverwaltungsordner hinzu, z. B. $/folder/*. Andernfalls werden standardmäßig alle untergeordneten Elemente des Versionssteuerungsordners rekursiv dem lokalen Arbeitsbereich zugeordnet.

Die Zuordnung einzelner Ordner innerhalb einer Versionssteuerungshierarchie ist nützlich, da sie die Anzahl der Elemente begrenzt, die auf den Clientcomputer heruntergeladen werden. Eine weitere Möglichkeit, heruntergeladene Dateien einzuschränken, besteht darin, Dateien zu verschließen, die Sie nicht in Ihrem Arbeitsbereich haben müssen. Weitere Informationen finden Sie unter Optimieren Ihres Arbeitsbereichs. Dieser Ansatz bietet schnellere Downloadzeiten und spart Speicherplatz auf dem Clientcomputer.

Löschen eines Arbeitsbereichs

Wenn Sie einen Arbeitsbereich löschen, der ausstehende Änderungen enthält, bricht TFVC die ausstehenden Änderungen im Rahmen des Löschvorgangs ab. Durch das Löschen eines Arbeitsbereichs werden die Dateien und Ordner auf dem Clientcomputer, die sich in diesem Arbeitsbereich befinden, nicht gelöscht.

Anmerkung

Befehle, die manuell ausgeführt werden, erfordern die Option /noprompt, um die Benutzerbestätigung zu umgehen. Achten Sie darauf, wenn Sie die PowerShell-Start()-Methode zum Ausführen von Befehlen verwenden. Die Option /noprompt kann in PowerShell automatisch festgelegt werden.

Beim Löschen eines Arbeitsbereichs müssen Sie die <workspace-owner> und <workspace-name>

Sie können den Befehl workspace verwenden, um diese Werte abzurufen. Weitere Informationen finden Sie unter Arbeitsbereichsbefehl. Um den <workspace-owner>-Wert zu finden, führen Sie den folgenden Befehl aus:

c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml

Um den <workspace-name> Wert zu finden, verwenden Sie den <OwnerId> Wert aus der Ausgabe des vorherigen Befehls als <workspace-owner> Wert. Dieser Wert weist das Format einer Azure Active Directory (Azure AD)-Objekt-ID gefolgt von einem umgekehrten Schrägstrich und einem Benutzerprinzipalnamen auf. Verwenden Sie den gesamten Wert. Führen Sie dann den folgenden Befehl aus:

c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`

Führen Sie zum Löschen des Arbeitsbereichs den folgenden Befehl aus:

c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`

Bearbeiten eines Arbeitsbereichs

Sie können die folgenden Arbeitsbereichsattribute ändern:

  • Arbeitsbereichsname
  • Kommentar
  • Zuordnungen von Arbeitsordnern

Wenn keine Arbeitsbereichsspezifikation angegeben wird, wird der Arbeitsbereich für den aktuellen Ordner verwendet.

Beispiele

Im folgenden Beispiel wird das Dialogfeld Arbeitsbereich hinzufügen geöffnet und ein neuer Arbeitsbereich erstellt. Sie können das Dialogfeld Arbeitsbereich hinzufügen verwenden, um den Quellcodeverwaltungsordner, Besitzer, Computer, Kommentar und lokale Ordner zu bearbeiten.

c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection

Im folgenden Beispiel wird ein neuer Arbeitsbereich namens Beta1 erstellt und jenh als Arbeitsbereichsbesitzer zugewiesen. Verfügen Sie über die AdminWorkspaces Berechtigung, einem anderen Benutzer den Besitz eines neuen Arbeitsbereichs zuzuweisen. Weitere Informationen zu Sicherheitsberechtigungen finden Sie unter Standard-TFVC-Berechtigungen.

c:\projects>tf workspace /new Beta1;jenh

Im folgenden Beispiel wird ein neuer Arbeitsbereich mithilfe des Beta1 Arbeitsbereichs erstellt, der im Besitz von jenh als Vorlage ist:

c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection

Im folgenden Beispiel wird der Beta1 Arbeitsbereich vom Server entfernt:

c:\projects>tf workspace /delete Beta1

Im folgenden Beispiel werden Eigenschaften für den aktuellen Arbeitsbereich bearbeitet:

c:\projects>tf workspace

Im folgenden Beispiel wird der Beta1 Arbeitsbereich geöffnet, der im Besitz jenh ist, sodass Sie dessen Eigenschaften und Zuordnungen sehen können. Wenn Sie über die AdminWorkspaces Berechtigung verfügen, können Sie die Arbeitsbereichseigenschaften und -zuordnungen ändern.

c:\projects> tf workspaces Beta1;jenh