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).
Hinweis
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:
|
/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
Einchecken von ausstehenden Änderungen
Sperren und Entsperren von Ordnern und Dateien