Befehl Lock
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 hierzu finden Sie unter Team Foundation Server-Berechtigungen.
tf lock itemspec /lock:(none|checkout|checkin)
[/workspace:workspacename] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parameter
Argument |
Beschreibung |
|---|---|
itemspec |
Identifiziert die Datei oder den Ordner, für die bzw. den eine Sperre festgelegt oder aufgehoben werden soll. Weitere Informationen zum Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen. .gif "Hinweis") Hinweis
Sie können mindestens ein Itemspec-Argument angeben.
|
workspacename |
Der vom Benutzer angegebene Wert für die /workspace-Option. |
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. |
TeamProjectCollectionUrl |
Die URL der Teamprojektauflistung, die die Datei oder den Ordner enthält, den Sie sperren oder entsperren möchten (z. B. http://myserver:8080/tfs/DefaultCollection). |
Option |
Beschreibungen |
|---|---|
/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. |
/login |
Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an. |
/collection |
Gibt die Teamprojektsammlung an. |
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.
Tipp
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 Befehlszeilenhilfsprogramms "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 Sperren und Entsperren von Ordnern und 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
Referenz
Befehlszeilensyntax (Versionskontrolle)
Konzepte
Erstellen eines Arbeitsbereichs zum Arbeiten mit dem Teamprojekt