Befehl Add
Fügt neue Dateien und Ordner von einem Speicherort im lokalen Dateisystem auf einem Server für die Quellcodeverwaltung in Team Foundation hinzu.
Hinweis
Die Ergebnisse dieses Befehls werden erst nach dem Ausführen eines Eincheckvorgangs im Server für die Quellcodeverwaltung in Team Foundation widergespiegelt. Weitere Informationen finden Sie unter Gewusst wie: Einchecken von ausstehenden Änderungen.
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. |
filetype |
Wird mit der Option /type verwendet. Weitere Informationen finden Sie unter Dateitypen. |
Option | Beschreibung |
---|---|
/type |
Überschreibt Dateitypvergleiche und fügt dem Quellcodeverwaltung in Team Foundation-Server, der den angegebenen Typ verwendet, Dateien hinzu. Weitere Informationen finden Sie unter Dateitypen. Die Dateityperkennung basiert auf dem Inhalt des ersten KB 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 in der Quellcodeverwaltung hinzufügen, 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-Quellcodeverwaltung über die Befehlszeile.
Add ist ein Befehl für Ausstehende Änderungen, mit dem die Elemente, die Sie als dem Server für die Quellcodeverwaltung in Team Foundation 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 Quellcodeverwaltung in Team Foundation zugeordnet werden.
Wenn Sie den Add -Befehl für das Hinzufügen eines neuen Elements zur Quellcodeverwaltung verwenden, wird das Element erst dann auf dem Server für die Quellcodeverwaltung in Team Foundation 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 Quellcodeverwaltung in Team Foundation 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 Quellcodeverwaltung in Team Foundation eincheckt, bevor Sie Ihre Änderungen einchecken können, fügen Sie die Option /lock 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 Quellcodeverwaltung 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 dabei einer der Ordner im angegebenen Pfad ($/teamproject, $/teamproject/projects oder $/teamproject/projects/math) auf dem Server für die Quellcodeverwaltung in Team Foundation 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 Quellcodeverwaltung in Team Foundation festzulegen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Quellcodeverwaltung über die Befehlszeile.
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
Sicherheit
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.
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Quellcodeverwaltung über die Befehlszeile
Gewusst wie: Hinzufügen von Dateien und Ordnern zur Quellcodeverwaltung, die keine Projekt- oder Projektmappendateien sind
Gewusst wie: Einchecken von ausstehenden Änderungen
Gewusst wie: Sperren und Entsperren von Ordnern oder Dateien
Konzepte
Ausstehende Änderungen
Grundlagen von Sperrentypen
Weitere Ressourcen
Befehle des Befehlszeilendienstprogramms "Tf"
Hinzufügen von Projekten und Projektmappen zur Quellcodeverwaltung