Features und Funktionen in Version 1.1 des Befehlszeilentools Client-Side Caching Command-Line Options

Dieser Artikel enthält Informationen zu den Features und Funktionen, die im Offlinedateiverwaltungstool CSCCMD 1.1 verfügbar sind.

Gilt für: Microsoft Windows XP und Microsoft Windows Server 2003
Ursprüngliche KB-Nummer: 884739

Einführung

Dieser Artikel enthält Informationen zu den Features und Funktionen in der neuesten Version des Befehlszeilentools Client-Side Caching Command-Line Options (CSCCMD) (Csccmd.exe).

Weitere Informationen

Sie können das CSCCMD-Tool verwenden, um Offlinedateien in Microsoft Windows 2000, in Microsoft Windows XP und in Microsoft Windows Server 2003 zu verwalten. Die neueste Version des CSCCMD-Tools ist 1.1. Version 1.1 enthält neue Funktionen und Features, die in früheren Versionen nicht verfügbar waren.

Hinweis

Benutzer, die das CSCCMD-Tool verwenden, müssen über gute Kenntnisse der clientseitigen Zwischenspeicherungsfunktionen verfügen.

Wenden Sie sich an den Microsoft-Produktsupport, um das CSCCMD-Tool zu erhalten. Eine vollständige Liste der Telefonnummern von Microsoft Product Support Services und Informationen zu Den Supportkosten finden Sie auf der folgenden Microsoft-Website:

Telefonnummern für den globalen Kundendienst

Hinweis

Sie können auch CSCCMD 1.0 und andere Tools als Teil der Windows Server 2003 Resource Kit-Tools herunterladen.

Das CSCCMD-Tool verwendet die folgende Syntax: CSCCMD [/RESID] [/ENABLE] [/DISABLE] [/DISCONNECT: \\Server\Share] [/MOVESHARE: \\Server\Share1 \\Server\Share2 ] [/?]

Die folgenden Befehlszeilenoptionen und ihre Funktionen sind in der neuesten Version des CSCCMD-Tools verfügbar:

  • /ENABLE : Verwenden Sie diesen Schalter, um Client-Side Caching (CSC) auf einem Client zu aktivieren. Mit diesem Switch können Sie auf Netzwerkdateien zugreifen und diese synchronisieren, während Sie offline arbeiten.

    Hinweis

    Sie müssen ein Administrator auf dem lokalen Computer sein, um diesen Switch verwenden zu können.

  • /DISABLE : Verwenden Sie diesen Schalter, um CSC zu deaktivieren. Bevor Sie diesen Befehl ausführen, müssen Sie sicherstellen, dass Sie alle Offlinedateien geschlossen haben. Wenn Sie CSC deaktivieren, können Sie nicht an Netzwerkdateien arbeiten, während Sie offline arbeiten.

    Hinweis

    Sie müssen ein Administrator auf dem lokalen Computer sein, um diesen Switch verwenden zu können.

  • /ENUM[:\\ Server\Share[\Path]] [/RECURSE] – Verwenden Sie diesen Schalter, um alle Freigaben im lokalen Cache anzuzeigen. Wenn Sie diesen Schalter mit der Option /RECURSE verwenden, zeigt das CSCCMD-Tool den Inhalt der Freigaben innerhalb einer übergeordneten Freigabe an. Sie können auch den Inhalt einer bestimmten Freigabe eines Servers anzeigen. Verwenden Sie dazu das Format \\Serverfreigabe\. Verwenden Sie beispielsweise den folgenden Befehl: CSCCMD /ENUM: \MyServer\MyShare

    Hinweis

    MyServer ist der Servername und MyShare der Name der freigegebenen Ressource.

  • /DISCONNECT: \\Serverfreigabe\: Verwenden Sie diesen Schalter, um einen bestimmten Server von Client-Side Zwischenspeicherung auf dem Clientcomputer zu trennen. Verwenden Sie das Format \\Serverfreigabe\, um den Namen einer bestimmten freigegebenen Ressource eines Servers anzugeben, den Sie trennen möchten. Verwenden Sie beispielsweise den folgenden Befehl: CSCCMD /DISCONNECT: \\MyServer\MyShare
    Der Hintergrund Client-Side Cache-Agent versucht nicht, die Verbindung mit dem Server wiederherzustellen. Wenn Sie Offlineinhalte mithilfe des Synchronisierungs-Managers synchronisieren, stellt der Client-Side Cache-Agent dann eine verbindung mit dem Server her, sofern er verfügbar ist.

    Hinweis

    Damit diese Funktion ordnungsgemäß funktioniert, muss ein Handle auf dieser Freigabe oder in einem beliebigen Verzeichnis/einer beliebigen Datei auf dieser Freigabe geöffnet sein.

  • /MOVESHARE: \\Server1\Freigabeserver2\\\Freigabe : Verwenden Sie diesen Schalter, um Dateien und Verzeichnisse von einer Freigabe in eine andere Freigabe im Cache zu verschieben. Diese Option ist nützlich, wenn das Ziel von Offlinedateien verschoben wurde und der lokale Cache jetzt auf einen neuen Speicherort verweisen muss. Verwenden Sie beispielsweise den folgenden Befehl: CSCCMD /MOVESHARE: \\MyServer\MyShare\\MyServer1\MyShare1

    Hinweis

    MyServer1 ist der neue Servername, und MyShare1 ist der Name der neuen freigegebenen Ressource.

  • /RESID : Verwenden Sie diesen Schalter, um alle Einträge in der Windows-Offlinedateien-Datenbank (CSC) mithilfe einer neuen Benutzersicherheits-ID (SID) neu zu stempeln. Dieser Switch wird in Szenarien verwendet, in denen ein organization Benutzerkonten aus einer Microsoft Windows NT 4.0-Domäne in eine Windows Server 2003-Domäne verschiebt.

    Wenn der Cache eines Benutzers mithilfe der Windows NT 4.0-SID des Benutzers sicherheitsgebessert wird, kann nicht über das Windows Server 2003-Konto auf den Cache zugegriffen werden, es sei denn, die Cacheeinträge werden mithilfe der Windows Server 2003-SID neu stempelt.

  • /ISENABLED oder /ISCSCENABLED: Verwenden Sie einen dieser Schalter, um zu bestimmen, ob CSC auf Ihrem Clientcomputer aktiviert ist.

  • /PIN2: \\server\share\path[/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] – Verwenden Sie diesen Schalter, um freigegebene Ressourcen anzuheften. Sie können die Option /USER verwenden, um eine Datei anzuheften. Diese Aktion hat das gleiche Ergebnis wie die Verwendung des Dialogfelds Offlinedateien , um die Datei zwischenzuspeichern. Die Option /SYSTEM gibt an, dass die freigegebene Ressource durch Konfigurieren der Gruppenrichtlinie Einstellungen administrativ angeheftet werden muss. Die Option /USERINHERIT und die Option /SYSTEMINHERIT]INHERIT legen fest, wie die Pindaten geerbt werden. Sie können eine beliebige Kombination der Pintypen verwenden.

  • /PIN2: Dateiname /FILELIST [/UNICODE] [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT]

  • Verwenden Sie diesen Schalter, wenn Sie eine Datei verwenden möchten, die alle Objekte beschreibt, die als Parameter angeheftet werden sollen. Die Datei enthält den UNC-Pfad (Universal Naming Convention) der anzuheftenden Objekte. Die Objekte werden durch einen Wagenrücklauf/Zeilenvorschub getrennt. Verwenden Sie beispielsweise den folgenden Befehl: CSCCMD /PIN: MyShare.txt /FILELIST

    Hinweis

    Die MyShare.txt Datei enthält Einträge, die durch Leerzeichen getrennt sind.

    Diese Einträge ähneln den folgenden:

    MyServer/MyShare //MyServer1/MyShare1

    Hinweis

    Der /PIN-Schalter kopiert den Inhalt der freigegebenen Ressource nicht in den lokalen Cache. Das Anheften reicht nicht aus, um die Dateien offline verfügbar zu machen. Nachdem Sie den Schalter /PIN verwendet haben, müssen Sie den CSCCMD-Befehl zusammen mit dem Schalter /FILL ausführen, um den Inhalt der freigegebenen Ressource in den lokalen Cache zu kopieren und sicherzustellen, dass die freigegebene Ressource offline verfügbar ist. Die Option /USERINHERIT und die Option /SYSTEMINHERIT]INHERIT legen fest, wie die Pindaten geerbt werden. Sie können eine beliebige Kombination der Pintypen verwenden.

  • /UNPIN2: \\server\share\path[/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] [/RECURSE]

  • Verwenden Sie diesen Schalter, um eine freigegebene Ressource zu lösen oder eine freigegebene Ressource aus dem lokalen Cache zu entfernen. Wenn Sie diesen Schalter mit der Option /RECURSE verwenden, löst das CSCCMD-Tool alle untergeordneten Elemente des Pfads. Wenn Sie diesen Schalter mit der Option /RECURSE2 verwenden, löst das CSCCMD-Tool den Pfad und die untergeordneten Elemente des Pfads. Sie können eine beliebige Kombination der Pintypen verwenden.

  • /UNPIN2: Filename /FILELIST [/UNICODE] [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] – Verwenden Sie diesen Schalter, um eine bestimmte Gruppe freigegebener Ressourcen mithilfe einer Datei zu lösen. Sie können eine beliebige Kombination der Pintypen verwenden.

    Hinweis

    Der Parameter /FILELIST gibt an, dass es sich bei der angegebenen Datei um eine Textdatei mit einem Dateinamen für jede Zeile handelt. Leerzeichen am Anfang einer Datei werden ignoriert. Allerdings werden alle Leerzeichen am Ende der Zeile gezählt. Zeilen werden durch eine beliebige Kombination von Wagenrücklaufzeichen, Zeilenvorschubzeichen oder beidem getrennt.

    Wenn Sie diesen Schalter mit der Option /UNICODE verwenden, erstellt das CSCCMD-Tool die Dateiliste im Unicode-Textformat.

  • /FILL: \\Serverfreigabepfad\\ – Verwenden Sie diesen Schalter, um serverseitige Daten für eine angegebene freigegebene Ressource in den lokalen Cache zu kopieren.

  • /FILL: FileName /FILELIST [/UNICODE]

  • Verwenden Sie diesen Schalter, um serverseitige Daten mithilfe einer Datei für einen Satz von angegebenen freigegebenen Ressourcen in den lokalen Cache zu kopieren.

    Hinweis

    Der Parameter /FILELIST gibt an, dass es sich bei der angegebenen Datei um eine Textdatei mit einem Dateinamen pro Zeile handelt. Leerzeichen am Anfang einer Datei werden ignoriert. Allerdings werden alle Leerzeichen am Ende der Zeile gezählt. Zeilen werden durch eine beliebige Kombination von Wagenrücklaufzeichen, Zeilenvorschubzeichen oder beidem getrennt.

    Wenn Sie diesen Schalter mit der Option /UNICODE verwenden, erstellt das CSCCMD-Tool die Dateiliste im Unicode-Textformat.

  • /DELETE: \\Serverfreigabepfad\\[/RECURSE] [/RECURSE2]

  • Verwenden Sie diesen Schalter, um eine Datei, ein Verzeichnis oder eine Freigabe aus dem lokalen Cache zu löschen. Um ein Verzeichnis oder eine Freigabe zu löschen, müssen Sie sicherstellen, dass das Verzeichnis oder die Freigabe leer ist, bevor Sie diesen Schalter verwenden. Wenn das Verzeichnis oder die Freigabe nicht leer ist, können Sie das Verzeichnis oder die Freigabe nicht löschen. Wenn die Datei geöffnet ist, können Sie die Datei nicht löschen. Wenn Sie diesen Schalter mit der Option /RECURSE verwenden, funktioniert das CSCCMD-Tool nur für die untergeordneten Elemente des Pfads. Wenn Sie diesen Schalter mit der Option /RECURSE2 verwenden, arbeitet das CSCCMD-Tool auf dem Pfad und den untergeordneten Elementen des Pfads.

  • /ISSERVEROFFLINE: \\Server : Verwenden Sie diesen Schalter, um zu bestimmen, ob CSC einen bestimmten Server als offline ansieht.

    Hinweis

    Bevor Sie diesen Schalter verwenden, müssen Sie alle Freigaben, Dateien oder Verzeichnisse öffnen, die im lokalen Cache für den Server gespeichert sind, den Sie überprüfen möchten. Wenn Sie dies nicht tun, meldet der CSCCMD-Befehl immer, dass der Server online ist. Außerdem ist der Serverzustand, den dieser Befehl meldet, der Zustand, den CSC erkennt. Dies ist nicht der tatsächliche Serverzustand.

  • /SETSPACE: Festzulegende Bytes : Verwenden Sie diesen Schalter, um den Speicherplatz in Bytes anzugeben, den Sie temporären Offlinedateien zuordnen möchten. Bei diesen temporären Offlinedateien handelt es sich um nicht angeheftete, automatisch zwischengespeicherte Dateien. Diese Funktion funktioniert ähnlich wie die Funktion, die im Dialogfeld Offlinedateien bereitgestellt wird.

  • /CHECKDB [/QUICK] – Verwenden Sie diesen Schalter, um die CSC-Datenbank zu untersuchen und alle Datenbankfehlerflags anzuzeigen. Wenn Sie diesen Schalter mit der Option /QUICK verwenden, überspringt das CSCCMD-Tool die Enumeration und zeigt nur die Datenbankfehler an.

  • /EXTRACT[:\\Server\Share[\Path ]] /TARGET: Path [/RECURSE] [/ONLYMODIFIED] [/STOPONERROR] – Verwenden Sie diesen Schalter, um eine Datei, ein Verzeichnis oder eine Verzeichnisstruktur aus dem lokalen Cache zu extrahieren. Sie können die Option /TARGET verwenden, um das Ziel anzugeben, in das Sie die Datei oder das Verzeichnis extrahieren möchten. Sie können einen Zielordner angeben, der bereits vorhanden ist, oder Sie können einen Zielordner angeben, der noch nicht vorhanden ist.

    Hinweis

    Wenn der von Ihnen angegebene Zielordner noch nicht vorhanden ist, erstellt der Prozess automatisch einen Ordner mit dem von Ihnen angegebenen Namen.

    Sie können die Option /ONLYMODIFIED verwenden, um nur die Dateien zu extrahieren, die offline geändert wurden. Wenn Sie die Option /STOPONERROR verwenden, wird der Extraktionsprozess beendet, wenn während des Extraktionsprozesses ein Fehler auftritt.

    Hinweis

    Da Dateien im Offlinecache NTFS-Dateisystemberechtigungen verwenden, müssen Sie administrator auf dem lokalen Computer sein, um den Schalter /EXTRACT verwenden zu können.