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:

  • 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.

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

Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Versionskontrolle über die Befehlszeile

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

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"