FileOperation¶
Beschreibung¶
Ermöglicht die Ausführung von Dateioperationen wie „Kopieren“, „Verschieben“ oder „Löschen“.
Syntax¶
FileOperation (Operation : <String>, Destination : <String>, Flags : <String>, CollisionBehavior : <String>, DirLevel : <Integer>, [optional]LogFile : <String>, [optional]UndoScript : <String>)
Parameter¶
- Operation
Der Vorgang, der bei einem bestimmten Scan ausgeführt werden soll, der zuvor durch die Angabe eines Wurzelverzeichnis definiert wurde. Folgende Vorgänge werden unterstützt:
- „Löschen“
- Löscht alle Dateien.
Achtung! Die Löschung kann nicht ohne weiteres rückgängig gemacht werden. Wenn Sie die Dateien in den Papierkorb verschieben möchten, verwenden Sie stattdessen den Vorgang „Recyceln“.
- „Recyceln“
Verschiebt alle Dateien in den Papierkorb (falls vorhanden, z. B. im Windows-Dateisystem).
- „Bewegung“
Verschiebt alle Elemente in den Pfad, der über den Parameter „Ziel“ angegeben ist.
- „Kopieren“
Kopiert alle Elemente in den Pfad, der über den Parameter „Ziel“ angegeben ist.
- „Reißverschluss“
Verschiebt alle Objekte in eine ZIP-Datei, die über den Parameter „Ziel“ angegeben wird. ZIP-Dateien, die Unicode-Pfade enthalten, können nur mit Unicode-kompatiblen ZIP-Extras wie WinRAR, WinZip oder 7-Zip korrekt entpackt werden.
- „Ausführen“
Eine ausführbare Datei, die über den Parameter „Ziel“ angegeben wird, wird für jedes Element aufgerufen, und der vollständige Pfad des Elements wird als Parameter in der Befehlszeile übergeben. Bei der ausführbaren Datei kann es sich auch um eine Powershell-, Batch- oder VBScript-Datei (oder etwas Ähnliches) handeln. Das Windows Scripting FileSystemObject bietet leistungsstarke und einfach zu verwendende Funktionen für Dateisystem- und Pfadoperationen.
- Reiseziel
Der Zielpfad für die über den Parameter „Operation“ definierte Operation. Im Falle von „Delete“ oder „Recycle“ wird der Parameter ignoriert.
- Flaggen
- Die Berechtigungen der ursprünglichen Datei werden für die Datei am neuen Speicherort verwendet.
Hinweis: Nur für die Operationen „Verschieben“ und „Kopieren“ verfügbar.
- „Erlaubnisse bewahren“
- Die Berechtigungen der ursprünglichen Datei werden für die Datei am neuen Speicherort verwendet.
Hinweis: Nur für die Operationen „Verschieben“ und „Kopieren“ verfügbar.
- „DeleteEmptyFolders“
- Löscht alle Ordner, die aufgrund eines Verschiebevorgangs geleert wurden.
Hinweis: Nur für die Operation „Verschieben“ verfügbar.
- „CreateShortCuts“
- Erstellt eine Verknüpfung am ursprünglichen Speicherort, die auf den Speicherort verweist, an den die Datei verschoben wurde.
Hinweis: Nur für die Operation „Verschieben“ verfügbar.
- „CreateLinks“
Erzeugt NTFS Hardlinks für eine verschobene Datei. Wenn die Erstellung eines Hardlinks nicht möglich ist, wird eine symbolische Verknüpfung verwendet. Wenn ein symbolischer Link nicht erstellt werden kann, wird eine Windows-Verknüpfung als Ausweichmöglichkeit verwendet. Hinweis: Nur für die Operation „Verschieben“ verfügbar.
- „KeepAfterZip“
- Aktivieren Sie diese Option, damit die Originaldateien nach dem Kopieren in eine ZIP-Datei nicht gelöscht werden.
Hinweis: Diese Option ist nur für den Vorgang „Zip“ verfügbar.
- „Zeitstempel erhalten“
- Die Zeitstempel der Originaldatei werden für die Datei am neuen Speicherort verwendet.
Hinweis: Nur für die Operationen „Verschieben“ und „Kopieren“ verfügbar.
- CollisionBehavior
- Legen Sie fest, wie Namenskollisionen behandelt werden sollen, wenn bei einem Verschiebevorgang eine Datei mit demselben Namen bereits am Zielort vorhanden ist.
Hinweis: Nur verfügbar für die Operationen „Verschieben“, „Kopieren“ oder „Zip“.
- „KeepExisting“
Eine bestehende Datei wird beibehalten und die neue Datei wird nicht kopiert, verschoben oder gezippt.
- „RenameExisting“
Eine bestehende Datei wird umbenannt (test.txt => test.txt.bak0) und die neue Datei wird kopiert, verschoben oder gezippt.
- „ReplaceExisting“
Eine bestehende Datei wird durch die neue Datei ersetzt.
- „ReplaceOlderExisting“
Das Änderungsdatum beider Dateien wird verglichen, und nur eine Datei mit einem neueren Zeitstempel wird eine ältere Datei am Zielort ersetzen. Andernfalls wird die Datei übersprungen.
- DirLevel
Verwenden Sie diese Option, um die Ebene der zu erhaltenden übergeordneten Verzeichnisse zu konfigurieren. Die ersten x übergeordneten Verzeichnisse werden nicht in den Zielpfad aufgenommen. Verwenden Sie -1, wenn Sie die Verzeichnisebene nicht beibehalten möchten. Wenn Sie beispielsweise die Datei „Mein Dokument.doc“ aus dem Scan „C:\temp“ in das Ziel „D:\Obsolete Files“ verschieben, erhalten Sie die folgenden Ergebnisse:
x = -1 > „D:\Überholte Dateien\Mein Dokument.doc“ x = 0 > „D:\Überholte Dateien\C\temp\Mein Dokument.doc“ x = 1 > „D:\Überholte Dateien\temp\Mein Dokument.doc“ x = 2 > „D:\Überholte Dateien\Mein Dokument.doc“
Hinweis: Nur verfügbar für die Operationen „Verschieben“, „Kopieren“ oder „Zip“.
- LogFile
Erzeugt eine Protokolldatei mit einem Namen Ihrer Wahl unter einem Pfad Ihrer Wahl. Umgebungsvariablen wie %DATE% oder %TIME% können im Dateinamen verwendet werden.
- UndoScript
- Erstellt eine Batch-Datei, die nach Abschluss des Vorgangs ausgeführt werden kann, um die während dieses Vorgangs vorgenommenen Änderungen rückgängig zu machen.
Hinweis: Nur für die Operationen „Verschieben“ und „Kopieren“ auf lokalen Windows-Dateisystemen verfügbar.
Beispiel¶
$SOS.FileOperation("Move", "C:\Backup", "[CreateShortCuts, PreserveTimestamps]", "ReplaceExisting", "0", "C:\logs\backup-log.txt")
SOS.FileOperation "Move", "C:\Backup", "[CreateShortCuts, PreserveTimestamps]", "ReplaceExisting", 0, "C:\logs\backup-log.txt"
Verschiebt alle Dateien eines (gefilterten) Scans in einen Backup-Ordner „C:\backup“ . Die Zeitstempel der Originaldateien bleiben erhalten und werden durch diesen Vorgang nicht verändert. Für jede Datei wird eine Verknüpfung im Quellordner hinterlegt. Die vollständige Verzeichnisstruktur der Dateien wird beibehalten, vorhandene Dateien im Zielordner werden ersetzt und eine Protokolldatei mit dem Namen „backup-log.txt“ wird unter „C:\logs“ erstellt.