Workspace-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Mit dem workspace-Befehl der Team Foundation-Versionskontrolle (TFVC) können Sie Eigenschaften und Zuordnungen, die einem Arbeitsbereich zugeordnet sind, erstellen, löschen, anzeigen oder ändern.

Voraussetzungen

  • Um einen vorhandenen Arbeitsbereich zu ändern oder zu löschen, müssen Sie der Besitzer sein, oder die globale Berechtigung Arbeitsbereiche verwalten muss auf Zulassen festgelegt sein.
  • Zum Erstellen eines Arbeitsbereichs muss die globale Berechtigung Arbeitsbereich erstellen auf Zulassen festgelegt sein.
  • Um Arbeitsbereiche für andere Benutzer zu erstellen, muss die Berechtigung Arbeitsbereiche verwalten auf Zulassen festgelegt sein.

Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

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

Tastatur

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. Bei dieser Option handelt es sich um eine erweiterte Option.
/comment Stellt einen Kommentar bereit, der den Arbeitsbereich beschreibt.
/newname Benennt einen vorhandenen Arbeitsbereich um.
/noprompt Führt den angegebenen Arbeitsbereichbefehl aus, ohne ein Dialogfeld anzuzeigen.
/collection Gibt die Projektsammlung an.
/permission Gibt die Optionen für Arbeitsbereichberechtigungen an:

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


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


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

    - local: Auf dem Clientcomputer. Dies 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 und enthält außerdem alle Änderungen, die Sie lokal vorgenommen haben. Wenn Sie ein Element mit Versionssteuerung hinzufügen, bearbeiten, löschen, verschieben, umbenennen oder anderweitig ändern, werden Ihre Änderungen in Ihrem Arbeitsbereich isoliert, in dem Sie Ihre Änderungen vornehmen und testen können. Wenn Sie Ihre Arbeit in die Codebasis des Teams einchecken, committen Sie Ihre Änderungen auf dem Server. Sie werden für andere Benutzer verfügbar, die sich außerhalb Ihres Arbeitsbereichs befinden.

Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Erstellen eines Arbeitsbereichs

Bevor Sie Dateien zum Versionskontrollserver hinzufügen oder Elemente auf dem Server auschecken können, müssen Sie einen Arbeitsbereich erstellen oder einem vorhandenen Arbeitsbereich dem aktuellen Verzeichnis zuordnen. Weitere Informationen finden Sie unter Einrichten Team Foundation-Versionskontrolle 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 Arbeitsordner einzugeben aus.
  3. Geben Sie im Feld Quellcodeverwaltungsordner den Serverpfad ein, dem Sie das aktuelle Verzeichnis zuordnen möchten.
  4. Geben Sie im Feld Lokaler Ordner das aktuelle Verzeichnis ein.
  5. Klicken Sie auf OK.

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

Zuordnung einzelner Ordner

Sie können nur die unmittelbar untergeordneten Elemente eines Versionskontrollordners einem lokalen Arbeitsbereich zuordnen. Fügen Sie dazu im Dialogfeld Arbeitsbereich hinzufügen im Feld Quellcodeverwaltungsordner das Platzhalterzeichen Sternchen (*) hinzu, z. B. $/folder/*. Andernfalls werden standardmäßig alle untergeordneten Elemente des Versionskontrollordners rekursiv dem lokalen Arbeitsbereich zugeordnet.

Die Zuordnung einzelner Ordner innerhalb einer Versionskontrollhierarchie 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 verbergen, die Sie in Ihrem Arbeitsbereich nicht benötigen. Weitere Informationen finden Sie unter Optimieren des Arbeitsbereichs. Dieser Ansatz ermöglicht 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. Beim Löschen eines Arbeitsbereichs werden die Dateien und Ordner auf dem Clientcomputer, die sich in diesem Arbeitsbereich befanden, nicht gelöscht.

Hinweis

Befehle, die manuell ausgeführt werden, erfordern die Option /noprompt zum Umgehen der Benutzerbestätigung. Gehen Sie vorsichtig vor, wenn Sie die PowerShell-Methode Start() verwenden, um Befehle auszuführen. Die /noprompt-Option kann in PowerShell automatisch festgelegt werden.

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

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

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 den folgenden Befehl aus, um den Arbeitsbereich zu erstellen.

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

Arbeitsbereich bearbeiten

Sie können die folgenden Arbeitsbereichattribute ändern:

  • Arbeitsbereichname
  • Comment
  • 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, den Besitzer, den Computer, den Kommentar und die lokalen 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 Besitzer des Arbeitsbereichs zugewiesen. Sie müssen über die Berechtigung AdminWorkspaces verfügen, um einem anderen Benutzer den Besitz eines neuen Arbeitsbereichs zuzuweisen. Weitere Informationen zu Sicherheitsberechtigungen finden Sie unter TFVC-Standardberechtigungen.

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

Im folgenden Beispiel wird ein neuer Arbeitsbereich erstellt, indem der Beta1-Arbeitsbereich als Vorlage verwendet wird, der sich im Besitz von jenh befindet:

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 sich im Besitz von jenh befindet, sodass Sie seine Eigenschaften und Zuordnungen anzeigen können. Wenn Sie über die Berechtigung AdminWorkspaces verfügen, können Sie die Arbeitsbereicheigenschaften und Zuordnungen ändern.

c:\projects> tf workspaces Beta1;jenh