Befehl Add
Aktualisiert: November 2007
Fügt neue Dateien und Ordner von einem Speicherort im lokalen Dateisystem auf einem Server für die Team Foundation-Versionskontrolle hinzu.
Hinweis: |
---|
Die Ergebnisse dieses Befehls werden erst nach dem Ausführen eines Eincheckvorgangs im Server für die Team Foundation-Versionskontrolle widergespiegelt. Weitere Informationen finden Sie unter Gewusst wie: 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. Außerdem müssen Sie über die Berechtigung Sperren verfügen, wenn /lock:checkout oder /lock:checkin verwendet wird. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
tf add itemspec [/lock:none|checkin|checkout] [/type:filetype]
[/noprompt] [/recursive]
Parameter
Argument |
Beschreibung |
---|---|
itemspec |
Kennzeichnet die hinzuzufügenden Dateien und Ordner. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Team System). |
filetype |
Wird mit der Option /type verwendet. Weitere Informationen finden Sie unter Dateitypen. |
Option |
Beschreibung |
---|---|
/type |
Überschreibt Dateitypvergleiche und fügt dem Team Foundation-Versionskontrolle-Server, der den angegebenen Typ verwendet, Dateien hinzu. Weitere Informationen finden Sie unter 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. |
Hinweise
Bevor Sie ein Element zur Versionskontrolle hinzufügen können, müssen Sie einen lokalen Arbeitsbereich und Zuordnungen für Arbeitsordner einrichten. Weitere Informationen für den Einstieg finden Sie unter Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Versionskontrolle über die Befehlszeile.
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 Gewusst wie: 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 hierzu finden Sie unter Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Versionskontrolle über die Befehlszeile.
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "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
Gewusst wie: Einchecken von ausstehenden Änderungen
Gewusst wie: Sperren und Entsperren von Ordnern oder Dateien