| Zweck: | Anzeige von Informationen über Dateien und Unterverzeichnisse inbenutzerdefinierbarenFeldern . Es handelt sich um einen "programmierbaren DIR"-Befehl. |
| Format: | PDIR [ranges] [/\ /A:[attrlist] /B CD:text /D /H /HL /I"text" /K /M /N[defhjlsvz] /O:[order] /P[n] /Q /S[[+]n] /T:t /(...)] [file...] |
| attrlist | Auswahlattribute (siehe Attributschalter für Details) |
| order | Hierarchische Liste von Sortierschlüsseln |
| ranges | Ein oder mehrere Datums-, Beschreibungs-, Ausschluss-, Größen- und Zeitbereiche |
| file | Eine oder mehrere aufzulistende Dateien |
| t | Zeitstempeltyp-Auswahlcode |
/A: |
Attribut auswählen |
Fußzeile anzeigen |
|
Nackte Dateinamen |
Optionen deaktivieren |
||
/CD:... |
COLORDIR-Zeichenkette |
Bestellung |
|
einfärben |
Seite pausieren |
||
nicht ausblenden . und .. |
Name des Eigentümers |
||
Harte Links |
Unterverzeichnisse |
||
/I"Text " |
Beschreibungsbereich |
/T[:t] |
Typ des Zeitstempels |
Kopfzeile anzeigen |
Ausgabefelder und Format |
Siehe auch: DIR, ATTRIB, DESCRIBE und SELECT.
Dateiauswahl
Unterstützt Attributschalter, erweiterte Wildcards, Bereiche, mehrere Dateinamen und Include-Listen.
Internet
Kann mit FTP/HTTP-Servernverwendet werden .
Verwendung
PDIR ist ein äußerst flexibler Befehl, mit dem Sie Informationen über Dateien und Verzeichnisse von einem oder mehreren lokalen oder entfernten Datenträgern oder Verzeichnissen in einer Vielzahl von benutzerdefinierten Formaten anzeigen können. Eine einfachere Version finden Sie unter dem Befehl DIR.
PDIR und DIR sind verwandt, haben aber nicht die gleichen Schalter und sind nicht für die gleiche Ausgabe gedacht. PDIR ist in erster Linie dazu gedacht, eine Ausgabe zu erzeugen, die anschließend von einem anderen Programm (oder einer Batch-Datei) geparst wird, oder (seltener) für eine spezielle Verzeichnisanzeige. Seine Optionen und Ausgaben sind auf diese Anwendungen ausgerichtet.
Die verschiedenen PDIR-Anzeigen werden über Optionen oder Schalter gesteuert. Der beste Weg, den Umgang mit den vielen Optionen des PDIR-Befehls zu lernen, ist das Experimentieren. Sie werden bald wissen, welche Optionen Sie regelmäßig verwenden wollen. Diese Optionen können Sie dann mit dem Befehl ALIASdauerhaft auswählen .
Die Option /(...) gibt an, welche Felder angezeigt werden sollen und wie sie formatiert werden sollen. (Sie können mehrere /(...)-Optionen in einer Zeile haben). Die Syntax lautet:
| a | Attribute |
| c | Komprimierung: Zeigt denProzentsatz derKomprimierung auf NTFS-Laufwerken mit aktivierter Komprimierung an. |
| d[...] | Datum (Sie müssen mindestens ein Unterfeld angeben, sonst bleibt das Feld leer) |
| d | Tag (2 Ziffern, führende Null) |
| m | Monat (2 Ziffern, führende Null) |
| y | Jahr (4 Ziffern) |
| f[...] | Datei- oder Verzeichnisname (Groß- und Kleinschreibung beachten) |
| P | SFN-Pfad |
| p | LFN-Pfad |
| N | SFN Dateiname |
| n | LFN Dateiname (Standard) |
| q | Schließen Sie den Dateinamen in doppelte Anführungszeichen ein, wenn er Leerzeichen oder Sonderzeichen enthält |
| i | Beschreibung |
| k | CKSUM-Hashwert (siehe die Funktion @CKSUM ) |
| m | MD5-Hashwert (siehe die Funktion @MD5 ) |
| q | Datei- oder Verzeichnisbesitzer (nur NTFS) |
| r | CRC32-Hashwert (siehe die Funktion @CRC32 ) |
| s | Streamnamen (nur NTFS) |
| sp | Pfad- und Streamnamen als Pfadname+Dateiname+Streamname (nur NTFS) |
| t[...] | Uhrzeit (Sie müssen mindestens ein Unterfeld angeben, sonst bleibt das Feld leer) |
| h | Stunden (2 Ziffern, führende Null) |
| m | Minuten (2 Ziffern, führende Null) |
| s | Sekunden (2 Ziffern, führende Null) |
| d | milliseconds (Dezimaltrennzeichen und 3 Ziffern) |
| z[...] | Größe |
| a | Zugewiesene Größe (diese ist in der Regel größer als die physische Größe, es sei denn, die Datei ist komprimiert). Beachten Sie, dass Sie die zugewiesene Größe auf FTP-Servern oder Netzwerk-Sharenames nicht erhalten können. |
| c | Die Größe wird mit dem Tausendertrennzeichen formatiert (Standard ist ein Komma) |
| k|K|m|M|g|G|t|T | (Groß-/Kleinschreibung wird beachtet) Format als Kilobyte, Megabyte, Gigabyte oder Terabyte, wie es in variablen Funktionen verwendet wird (siehe Speichergröße / Festplattenplatz / Dateigrößeneinheiten und Berichtsformat). Beachten Sie, dass die Größe nicht gerundet, sondern abgeschnitten wird. |
@funktion[*]
| ruftdie angegebene Variablenfunktion (intern oder benutzerdefiniert) auf . Um den aktuellen Dateinamen anzugeben, verwenden Sie * als Parameter. Zum Beispiel zeigtpdir /(f @md5[*]) den Dateinamen und den MD5-Hash an. Beachten Sie, dass das Präfix % des Funktionsnamens NICHT mit dem symbolischen Parameter * verwendet wird . Wenn der Parameter der Funktion nicht der symbolische * ist oder es sich um eine "innere" Funktion handelt, muss das %-Präfix verdoppelt werden, z. B.@function1[%%@function2[*]] |
| "..." | Wörtliche Zeichenkette (in Anführungszeichen). Die Zeichen werden soangezeigt, wie sie sind, mit der Ausnahme, dass Escape-Zeichen umgewandelt werden. |
Sie können auch ein Format angeben, unabhängig für jedes Feld, indem Sie dem Feldzeichen seine Formatspezifikation voranstellen:
| [-]i.a |
wobei
- den linken Blocksatz anstelle des standardmäßigen rechten Blocksatzes angibt ;
i gibt die minimale Feldbreite an, und
a diemaximale Feldbreite angibt.
Wenn die erste Ziffer von i gleich 0 ist , wird das Feld mit Nullen statt mit Leerzeichen aufgefüllt. Einige Felder können nicht unter eine Mindestbreite reduziert werden (z. B. muss das Feldz (Größe) mindestens 15 Stellen haben).
Wenn eine PDIR-Zeile leer ist (z. B. bei einem eingebetteten @IF), wird sie nicht angezeigt.
Wenn Sie Felder ohne Leerzeichen dazwischen oder mit einem benutzerdefinierten Trennzeichen anhängen wollen, können Sie Argumente in Anführungszeichen angeben. Zum Beispiel, um das Datum und die Uhrzeit ohne Leerzeichen dazwischen anzuzeigen:
pdir /(dymd""thms) *
Oder um das Datum und die Uhrzeit getrennt durch ein + anzuzeigen:
pdir /(dymd "+"thms) *
PDIR setzt drei interne Variablen:
| %_pdir_dirs | Die Anzahl der erstellten Verzeichnisse |
| %_pdir_files | Die Anzahl der verschobenen Dateien |
| %_pdir_errors | Die Anzahl der Fehler |
Beispiel
Um den CRC, den vollständigen LFN und den Eigentümer jeder Datei anzuzeigen:
pdir /(r fpn q) *
Optionen:
Optionen in der Befehlszeile gelten nur für die Dateinamen, die auf die Option folgen, und Optionen am Ende der Zeile gelten nur für den vorangehenden Dateinamen. Auf diese Weise können Sie für verschiedene Dateigruppen unterschiedliche Optionen angeben, wobei die Kompatibilität mit dem herkömmlichen DIR-Befehl bei Angabe eines einzelnen Dateinamens gewahrt bleibt .
Die meisten Optionen werden verwendet, um die gewünschten Dateien/Verzeichnisse auszuwählen. (Dies steht im Gegensatz zum DIR-Befehl.) Die spezielle Option /(...) wird verwendet, um anzugeben, welche Merkmale der ausgewählten Dateien oder Verzeichnisse in welcher Reihenfolge und in welchem Format angezeigt werden sollen.
| /A:... | Es werden nur die Dateien angezeigt, für die das/die angegebene(n) Attribut(e) gesetzt ist/sind. Informationen zu den Attributen, die auf /A: folgen können ,finden Sie unter Attributschalter. |
Sie können /A:=angeben , um ein Dialogfeld anzuzeigen, das Sie bei der Einstellung einzelner Attribute unterstützt.
/B1 zeigt relative Pfade an, wenn es zusammen mit /S verwendet wird. (Normalerweise zeigt /B den vollständigen Pfadnamen für die Datei an).
| /CD: | Definieren Sie eine benutzerdefinierte Zeichenkette zur Einfärbung des Verzeichnisses, die anstelle der Umgebungsvariablen COLORDIR oder der Option ColorDir in TCMD.INI verwendet werden soll. |
| /D | Die Verzeichnisliste wird nicht eingefärbt. Siehe DIR für weitere Informationen zur Einfärbung von Verzeichnissen. |
| /I "text" | Wählt Dateinamen anhand des Textes in ihren Beschreibungen aus. Siehe Beschreibungsbereiche für Details. |
| d | Versteckte Verzeichnisse überspringen (bei Verwendung mit /S) |
| e | Fehler nicht anzeigen |
| f | Freie Bytes in der Fußzeile unterdrücken |
| h | Unterdrücke den Header |
| j | Abzweigungen überspringen (bei Verwendung mit /S) |
| l | Link-Namen für symbolische Links nicht anzeigen |
| m:n | Maximal n Verzeichniseinträge anzeigen |
| s | Unterdrücke die Fußzeile |
| v | Unterdrücke die Datenträgerbezeichnung in der Kopfzeile |
| z | Systemverzeichnisse überspringen (bei Verwendung mit /S) |
| n | Nach Dateiname und Erweiterung sortieren (Standard). Wenn auche angegeben ist, wird nur nach dem Namen sortiert. |
| - | Kehrt die Sortierreihenfolge für die nächste Option um |
| a | Sortiert Namen und Erweiterungen in der Standard-ASCII-Reihenfolge, anstatt numerisch zu sortieren, wenn Ziffern im Namen oder in der Erweiterung enthalten sind. |
| c | Sortieren nach Kompressionsverhältnis (die am wenigsten komprimierte Datei in der Liste wird zuerst angezeigt). |
| d | Sortieren nach Datum und Uhrzeit (älteste Datei zuerst); siehe auch /T:acw |
| e | Sortieren nach Erweiterung |
| g | Erst Unterverzeichnisse, dann Dateien gruppieren |
| i | Nach Dateibeschreibung sortieren (wird ignoriert, wenn auch/C oder /O:c verwendet wird). |
| o | Nach Eigentümer sortieren |
| r | Umkehrung der Sortierreihenfolge für alle Optionen |
| s | Sortieren nach Größe |
| t | Gleich wied |
| u | Unsortiert |
| x | Kombiniert mit /S, sortiert die Ergebnisse aller Verzeichnisse zusammen und zeigt sie in einer einzigen Liste an. Beachten Sie, dass /O:x die Kopf- und Fußzeilen ausschaltet. |
| /P[n] | Warten Sie nach jeder Bildschirmseite auf das Drücken einer Taste, bevor Sie die Anzeige fortsetzen. Ihre Optionen an der Eingabeaufforderung werden unter Seiten- und Dateieingabeaufforderungenausführlich erläutert . Die Option /P hat ein optionales Argument n, das die Anzahl der Sekunden angibt, die auf einen Tastendruck gewartet werden soll, bevor die Anzeige fortgesetzt wird. |
| /S | Zeigt Dateiinformationen aus dem aktuellen Verzeichnis und allen zugänglichen Unterverzeichnissen an . |
Wenn Sie nach dem /S eine Zahl angeben, beschränkt PDIR die Rekursion der Unterverzeichnisse auf diese Zahl. Wenn Sie zum Beispiel einen Verzeichnisbaum "\a\b\c\d\e" haben, betrifft /S2 nur die Verzeichnisse "a", "b" und "c".
Wenn Sie nach dem /S ein + gefolgt von einer Zahl angeben , zeigt PDIR keine Dateinamen an, bis es diese Tiefe im Unterverzeichnisbaum erreicht hat. Wenn Sie zum Beispiel einen Verzeichnisbaum \a\b\c\d\ehaben , zeigt /S+2 den Inhalt von \a oder \a\b nicht an .
| a | Datum und Uhrzeit des letzten Zugriffs (NTFS-Volumes). |
| c | Erstellungsdatum und -uhrzeit. |
| w | Datum und Uhrzeit des letzten Schreibvorgangs (Standard). |
Wenn /T nicht angegeben wird, ist der Standardwert /T:w.
Wenn Sie ein u an das Feldanhängen , zeigt DIR die Dateizeit in UTC an.
Hinweis: Wenn mehr als ein Zeittyp angegeben wird, wird der erste angegebene Typ verwendet und alle nachfolgenden ignoriert.