Befehl Lock
Aktualisiert: November 2007
Sperrt oder entsperrt eine Datei oder einen Ordner, mit der Benutzern die Berechtigung für das Auschecken eines Elements für die Bearbeitung in einen anderen Arbeitsbereich oder das Einchecken ausstehender Änderungen an einem Element aus einem anderen Arbeitsbereich entzogen wird.
Erforderliche Berechtigungen
Sie können den lock-Befehl nur verwenden, wenn die Berechtigung Sperren auf Zulassen festgelegt ist. Zum Aufheben einer Sperre von einem anderen Benutzer muss die Berechtigung zum Entsperren der Änderungen anderer Benutzer auf Zulassen festgelegt sein, wenn Sie für den Arbeitsbereich dieses Benutzers nicht über die Berechtigung Schreiben verfügen. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
tf lock itemspec /lock:(none|checkout|checkin)
[/workspace:workspacename] [/server:servername] [/recursive]
Parameter
Argument |
Beschreibung |
|---|---|
itemspec |
Identifiziert die Datei oder den Ordner, für die bzw. den eine Sperre festgelegt oder aufgehoben werden soll. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen. |
workspacename |
Der vom Benutzer angegebene Wert für die /workspace-Option. |
servername |
Der vom Benutzer angegebene Wert für die /server-Option. Beispiel: http://teamfoundation2:8080/. |
Option |
Beschreibung |
|---|---|
/lock |
Gibt einen Sperrtyp an oder entfernt die Sperre eines Elements. Weitere Informationen finden Sie unter Grundlagen von Sperrentypen. Sperroptionen:
|
/workspace |
Gibt den Namen eines anderen Arbeitsbereichs an, in dem die Sperre angewendet werden soll. Standardmäßig wird die Sperre in dem Arbeitsbereich angewendet, in dem Sie sich gerade befinden. |
/server |
Gibt den URL des Servers für die Team Foundation-Versionskontrolle an, auf dem gearbeitet werden soll. Diese Option ist erforderlich, wenn der Befehl aus einem Verzeichnis aufgerufen wird, das keinem Arbeitsbereich zugeordnet ist. |
Hinweise
Sie können den Befehl lock zum temporären Sperren der Version eines Elements auf dem Server für die Team Foundation-Versionskontrolle verwenden, sodass Sie eine ausstehende Änderung einchecken können, ohne Zusammenführungskonflikte beheben zu müssen. Wenn Sie den Zugriff auf ein Element auf dem Server für die Team Foundation-Versionskontrolle dauerhaft verhindern möchten, sollten Sie stattdessen Befehl Permission verwenden.
.gif "Hinweis") Hinweis: |
|---|
Informieren Sie Ihre Teammitglieder, wenn Sie ein Element sperren, erläutern Sie den Grund für die Sperre und geben Sie an, wann Sie ungefähr planen, die Sperre wieder aufzuheben. |
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".
Gewusst wie: Sperren eines Elements
Sie können ein Element mit dem Befehl lock oder durch Angabe einer Sperroption bei der Ausführung anderer Befehle des Befehlszeilenprogramms tf sperren:
Bei den Befehlen add und branch gilt die Sperre für den Namespace, in dem das neue Element erstellt wird. Mit rename festgelegte Sperren gelten sowohl für die alten als auch für die neuen Namespaces. Weitere Informationen finden Sie unter Gewusst wie: Sperren und Entsperren von Ordnern oder Dateien.
Typen von Sperren
Team Foundation bietet zwei Typen von Sperren: checkin und checkout.
Eine Einchecksperre ist weniger restriktiv als eine Auschecksperre. Wenn Sie eine Einchecksperre anwenden, können die Benutzer weiter lokale Änderungen an dem Element in anderen Arbeitsbereichen vornehmen. Die Änderungen können erst dann eingecheckt werden, wenn Sie die Einchecksperre aus dem Arbeitsbereich explizit entfernen.
Eine Auschecksperre ist restriktiver als eine Einchecksperre. Wenn Sie eine Auschecksperre auf eine Datei oder einen Ordner anwenden, die bzw. der der Versionskontrolle unterliegt, können die Benutzer die Datei weder für die Bearbeitung auschecken noch bereits vorhandene ausstehende Änderungen einchecken. Sie können keine Auschecksperre festlegen, wenn derzeit ausstehende Änderungen für ein Element vorhanden sind.
Weitere Informationen über Situationen für Auschecksperren und Einchecksperren finden Sie unter Grundlagen von Sperrentypen.
Funktionsweise von Sperren
Wenn Sie eine ausgecheckte Datei sperren, wird ihr Status mit dem neuen Sperrtyp geändert. Wenn die Datei nicht ausgecheckt ist, wird die Änderung "lock" zu den ausstehenden Arbeitsbereichsänderungen hinzugefügt. Im Gegensatz zum checkout -Befehl werden Dateien mit lock nicht automatisch bearbeitbar.
Sperren für Ordner sind implizit rekursiv. Wenn Sie einen Ordner sperren, müssen Sie die enthaltenen Dateien nur dann sperren, wenn Sie eine restriktivere Auschecksperre auf eine Datei in einem Ordner mit einer Einchecksperre anwenden möchten.
Entsperren eines Elements
Sie können ein gesperrtes Element mit der Option none entsperren. Darüber hinaus entsperrt Team Foundation ein Element automatisch, wenn Sie ausstehende Änderungen im Arbeitsbereich einchecken.
Sie können die auf einem Server für die Team Foundation-Versionskontrolle gesperrten Dateien mit dem Befehl Status ermitteln. Mit diesem Befehl erfahren Sie auch, wer die Dateien gesperrt hat.
Beispiele
Im folgenden Beispiel wird verhindert, dass andere Benutzer 314.cs auschecken.
c:\projects>tf lock /lock:checkout 314.cs
Im folgenden Beispiel wird verhindert, dass andere Benutzer Änderungen an 1256.cs einchecken, sie können die Datei aber in ihren Arbeitsbereichen auschecken.
c:\projects>tf lock /lock:checkin 1256.cs
Im folgenden Beispiel wird verhindert, dass andere Benutzer ausstehende Änderungen an Elementen im Ordner src/ auf dem Server für die Team Foundation-Versionskontrolle einchecken.
c:\projects>tf lock /lock:checkout $/src
Im folgenden Beispiel werden sämtliche Dateien im Ordner src/ auf dem Server für die Team Foundation-Versionskontrolle entsperrt und für das Aus- und Einchecken durch andere Benutzer verfügbar gemacht.
c:\projects>tf lock /lock:none src/
Siehe auch
Konzepte
Arbeiten mit Versionskontrollarbeitsbereichen
Referenz
Befehlszeilensyntax (Team System)