Freigeben über


Befehl Add

Fügt neue Dateien und Ordner von einem lokalen Dateisystem auf einem Server für die Team Foundation-Versionskontrolle hinzu.

Tipp

   Die Ergebnisse dieses Befehls werden erst nach dem Ausführen eines Eincheckvorgangs auf dem Server für Team Foundation-Versionskontrolle übernommen. Weitere Informationen finden Sie unter Einchecken von ausstehenden Änderungen.

Erforderliche Berechtigungen

Um den add-Befehl verwenden zu können, müssen Sie Besitzer des Arbeitsbereichs sein und über die Berechtigung Auschecken für den übergeordneten Ordner der neuen Elemente verfügen. Die Berechtigung Sperren muss ebenfalls auf Zulassen festgelegt sein, wenn Sie /lock:checkout oder /lock:checkin verwenden. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.

tf add itemspec [/lock:(none|checkin|checkout)] [/type:filetype] 
[/noprompt] [/recursive] [/login:username,[password]] 

Parameter

Argument

Beschreibungen

itemspec

Bezeichnet die hinzuzufügenden Dateien oder Ordner. Weitere Informationen zum Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Versionskontrolle).

HinweisHinweis
Sie können mindestens ein Itemspec-Argument angeben.

filetype

Wird mit der Option /type verwendet. Weitere Informationen finden Sie unter Verwalten von Dateitypen.

username

Gibt einen Wert für die /login-Option an. Sie können als Wert für einen Benutzernamen entweder Domäne\Benutzername oder Benutzername angeben.

Option

Beschreibungen

/type

Überschreibt Dateitypvergleiche und fügt dem Team Foundation-Versionskontrolle-Server, der den angegebenen Typ verwendet, Dateien hinzu. Weitere Informationen finden Sie unter Verwalten von Dateitypen.

Die Dateityperkennung basiert auf dem Inhalt der ersten Kilobytes der Datei.

/lock

Gibt einen Sperrtyp an oder entfernt die Sperre eines Elements.

Sperroptionen:

  • None

    Für das Element wird keine Sperre festgelegt. Wenn bereits eine Sperre vorhanden ist, wird sie aufgehoben.

  • Checkin

    Ermöglicht das Auschecken und Bearbeiten von Elementen in allen Arbeitsbereichen, verhindert aber das Einchecken der Änderungen durch Benutzer außerhalb dieses /workspace , bis Sie die Einchecksperre explizit aufheben. Wenn das angegebene Element in einem anderen Arbeitsbereich gesperrt ist, schlägt der Sperrvorgang fehl.

  • Checkout

    Verhindert das Auschecken der angegebenen Elemente durch Benutzer, bis Sie die Sperre explizit aufheben. Wenn andere Benutzer eines der Elemente gesperrt haben oder ausstehende Änderungen für diese Elemente vorhanden sind, schlägt der Sperrvorgang fehl.

/noprompt

Unterdrückt alle Eingabeaufforderungen.

/recursive

Fügt alle Elemente im angegebenen Verzeichnis und in sämtlichen Unterverzeichnissen hinzu.

/login

Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an.

Hinweise

Bevor Sie ein Element zur Versionskontrolle hinzufügen können, müssen Sie einen lokalen Arbeitsbereich und Zuordnungen für Arbeitsordner einrichten.

Add ist ein Befehl für Ausstehende Änderungen, mit dem die Elemente, die Sie als dem Server für die Team Foundation-Versionskontrolle hinzuzufügende Elemente angeben, nach Abschluss eines Eincheckvorgangs aus Arbeitsbereich hinzugefügt werden. Zum Ausführen eines Befehls für ausstehende Änderungen muss das aktuelle Verzeichnis einem Arbeitsbereich und dem zugehörigen Server für die Team Foundation-Versionskontrolle zugeordnet werden.

Wenn Sie den Befehl Add für das Hinzufügen eines neuen Elements zur Versionskontrolle verwenden, wird das Element erst dann auf dem Server für die Team Foundation-Versionskontrolle hinzugefügt, wenn Sie die aktuellsten Änderungen am Arbeitsbereich einchecken. Das Element wird zunächst der Liste von ausstehenden Änderungen im aktuellen Arbeitsbereich hinzugefügt. Zum Hinzufügen auf dem Server für die Team Foundation-Versionskontrolle können Sie die hinzugefügte Datei entweder direkt einchecken, oder Sie können alle ausstehenden Änderungen im lokalen Arbeitsbereich einchecken. Wenn Sie vermeiden möchten, dass ein anderer Benutzer eine Datei oder einen Ordner mit demselben Namen wie Ihre ausstehende Änderung auf dem Server für die Team Foundation-Versionskontrolle hinzufügt, bevor Sie Ihre Änderungen einchecken können, fügen Sie die Option /lock mit dem Checkout-Parameter ein, um den Namespace zu reservieren und dieses zu verhindern. Weitere Informationen finden Sie unter Einchecken von ausstehenden Änderungen.

Wenn Sie mithilfe von tf add /teamproject/projects/math/314.cs der Versionskontrolle 314.cs hinzufügen, werden diese Ordner, sofern sie nicht bereits vorhanden sind, als ausstehende hinzugefügte Elemente behandelt, bis Sie die Änderungen einchecken. Wenn Sie die Änderungen einchecken und dabei einer der Ordner im angegebenen Pfad (/teamproject, /teamproject/projects oder /teamproject/projects/math) auf dem Server für die Team Foundation-Versionskontrolle nicht vorhanden ist, erstellt Team Foundation diese automatisch.

Sie können den Befehl Add verwenden, um die ursprüngliche Dateistruktur eines Servers für die Team Foundation-Versionskontrolle festzulegen.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".

Beispiele

Im folgenden Beispiel werden die Dateien 314.c und 1256.c in der Liste der ausstehenden Änderungen für den Arbeitsbereich hinzugefügt, der dem Arbeitsordner C:\Pi zugeordnet ist.

c:\pi>tf add 314.cs 1256.c

Im folgenden Beispiel werden alle C#-Quellcodedateien (.cs) im aktuellen Verzeichnis und in sämtlichen Unterverzeichnissen in der Liste der ausstehenden Änderungen für den aktuellen Arbeitsbereich hinzugefügt.

c:\projects>tf add *.cs /recursive

Im folgenden Beispiel werden alle Dateien und Ordner im aktuellen Verzeichnis sowie in sämtlichen Unterordnern, deren Namen "hello" enthalten, in der Liste der ausstehenden Änderungen für den Arbeitsbereich hinzugefügt, der c:\projects zugeordnet ist.

c:\projects>tf add *hello* /recursive

Siehe auch

Aufgaben

Hinzufügen von Dateien, die keine Projektdateien oder Projektmappendateien sind, und von Ordnern zur Versionskontrolle

Einchecken von ausstehenden Änderungen

Sperren und Entsperren von Ordnern und Dateien

Konzepte

Ausstehende Änderungen

Grundlagen von Sperrentypen

Weitere Ressourcen

Befehle des Befehlszeilenhilfsprogramms "Tf"

Stellen von Dateien unter Versionskontrolle