Verwenden der VSS-Befehlszeile
Sie können die Befehlszeile von VSS verwenden, um Stapelverarbeitungsdateien und Makros auszuführen. Darüber hinaus können Sie in der Befehlszeile sämtliche Befehle von VSS Explorer ausführen. Ausführliche Informationen zu einem bestimmten Befehl finden Sie unter Verwenden von Befehlszeilenbefehlen und -optionen.
Ausführen von Befehlen in der Befehlszeile
Sie können unter Windows eine Eingabeaufforderung starten und an der Eingabeaufforderung VSS-Befehle eingeben. Dafür müssen Sie die folgenden Benutzerumgebungsvariablen festlegen:
- PATH gibt den Pfad für ausführbare Dateien an. Fügen Sie den Pfad zu dem Ordner \Win32 ein, in dem standardmäßig die VSS-Programmdateien enthalten sind. Beispiel: PATH=%PATH%;c:\Program Files\vss\win32.
- SSDIR gibt den Speicherort der SRCSAFE.INI-Datei für die VSS-Datenbank an, mit der Sie eine Verbindung herstellen möchten.
Sie können auch im Startmenü von Windows auf Ausführen klicken, um einen bestimmten Befehl auszuführen. Sie können z. B. ss Get *.* eingeben, um alle Dateien im aktuellen Projekt abzurufen.
Befehlszeilensyntax
Befehlszeilenbefehle weisen die folgende allgemeine Syntax auf:
ssBefehl [ein oder mehrere Elemente] [eine oder mehrere Optionen]
Welche Bedeutung der Oberbegriff "Element" hat, hängt vom jeweiligen Befehl ab. Bei dem Befehl Get (Abrufen) stellt ein Element z. B. eine VSS-Datei oder ein VSS-Projekt dar, bei dem Befehl Add (Hinzufügen) hingegen steht das Element für eine Betriebssystemdatei.
In fast allen Fällen, in denen Sie ein Element angeben können, auf das eine Aktion ausgeführt werden soll, ist die Angabe mehrerer Elemente möglich. Beispielsweise sind alle nachstehenden Möglichkeiten zulässige Methoden für das Ausführen des Befehls Get:
ss Get HELLO.C
ss Get HELLO.C HELLO.H TEST.H makefile
ss Get *.C *.H makefile linkfile
ss Get *.*
In der Befehlszeile wird die Groß-/Kleinschreibung bei den Befehlen nicht beachtet, d.h., der Befehl ss Get HELLO.C kann also auch als ss get HEllo.c eingegeben werden. Allerdings muss bei einigen Befehlen, z. B. SS Find die Groß-/Kleinschreibung für die Suche nach einer Zeichenfolge beachtet werden. Wenn Sie beispielsweise nach Post suchen, indem Sie den Befehl
SS find post alias.txt
ausführen, werden nur Suchergebnisse angezeigt, die post enthalten, nicht aber Post. Verwenden Sie in der Befehlszeile die Option -ic, um die Groß-/Kleinschreibung in Suchzeichenfolgn nicht zu beachten.
Hinweis Sie müssen nicht den vollständigen Befehlsnamen in die VSS-Befehlszeile eingeben, damit dieser erkannt wird. Sie müssen nur jenen Teil des Befehls eingeben, der es VSS ermöglicht, den Befehl von jedem anderen zu unterscheiden. In den meisten Fällen reicht die Eingabe der ersten zwei oder drei Zeichen.
Befehlszeilenoptionen
Zusätzlich zu dem Befehl und den Elementen können Sie Optionen oder Parameter eingeben. Optionen, die mit einem vorangestellten Bindestrich eingegeben werden, ändern die Art und Weise, in der ein Befehl ausgeführt wird. Einige Optionen gelten nur für einen bestimmten Befehl und werden daher in dem Befehlszeilenhilfethema zu dem jeweiligen Befehl beschrieben. Darüber hinaus steht eine Reihe allgemeiner Optionen zur Verfügung, die auf viele Befehle angewendet werden können. Diese werden in der folgenden Tabelle beschrieben.
| Option | Beschreibung |
|---|---|
| -C | Verwenden eines (oder keines) Kommentars für alle angegebenen Elemente. (Bei dem Befehl Dir wirkt sich diese Option auf andere Weise aus.) |
| -O | Umbrechen oder Umleiten der Befehlsausgabe. |
| -V | Ausführen des Befehls für eine bestimmte Version eines Elements. |
| -R | Rekursives Ausführen eines Befehls. |
| -S | Aktivieren oder Deaktivieren des Smart-Modus für den Befehl. |
| -G | Ändern der Funktionsweise des Befehls Get für alle Dateien, die auf das lokale Laufwerk abgerufen werden. |
| -W | Gibt an, ob lokale Kopien schreibgeschützt sind. |
| -N | Wechseln zwischen den Modi für lange und kurze Dateinamen. |
| -I- | Ignorieren, d.h., es wird unter keinen Umständen zur Eingabe aufgefordert. |
| -Y | Angeben des Benutzernamens und Kennwortes. |
| -?, -H | Aufrufen der Hilfe mit einem Befehl: Mit der Befehlszeilenoption -H wird dasselbe Ergebnis erzielt. |
Schließen Sie den gesamten Parameter in Anführungszeichen ein, wenn ein Element oder eine Option ein Leerzeichen als Teil einer Textzeichenfolge enthält. Verwenden Sie z. B. "-CDies ist der Kommentar" anstelle von -C"Dies ist der Kommentar". Andernfalls interpretiert VSS das Leerzeichen als Trennzeichen zwischen verschiedenen Parametern, und der Befehl schlägt fehl oder liefert unerwartete Ergebnisse.
Siehe auch
Befehlszeilenoptionen | Verwenden von Beendigungscodes der Befehlszeile | Directory (Befehlszeile) | Starten von VSS in der Befehlszeile | Eingeben von Kommentaren in der Befehlszeile | Verwenden alternativer Befehlszeilenbefehle | Verwenden von Befehlszeilenbefehlen und -optionen | Referenz