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...]

 

attrlistAuswahlattribute (siehe Attributschalter für Details)
orderHierarchische Liste von Sortierschlüsseln
rangesEin oder mehrere Datums-, Beschreibungs-, Ausschluss-, Größen- und Zeitbereiche
fileEine oder mehrere aufzulistende Dateien
tZeitstempeltyp-Auswahlcode

 

/A:

Attribut auswählen

/M

Fußzeile anzeigen

/B

Nackte Dateinamen

/N

Optionen deaktivieren

/CD:...

COLORDIR-Zeichenkette

/O

Bestellung

/D

einfärben

/P

Seite pausieren

/H

nicht ausblenden . und ..

/Q

Name des Eigentümers

/HL

Harte Links

/S

Unterverzeichnisse

/I"Text "

Beschreibungsbereich

/T[:t]

Typ des Zeitstempels

/K

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:

 

aAttribute

 

cKomprimierung: Zeigt denProzentsatz derKomprimierung auf NTFS-Laufwerken mit aktivierter Komprimierung an.

 

d[...] Datum (Sie müssen mindestens ein Unterfeld angeben, sonst bleibt das Feld leer)
dTag (2 Ziffern, führende Null)
mMonat (2 Ziffern, führende Null)
yJahr (4 Ziffern)

 

f[...]Datei- oder Verzeichnisname (Groß- und Kleinschreibung beachten)
PSFN-Pfad
pLFN-Pfad
NSFN Dateiname
nLFN Dateiname (Standard)
qSchließen Sie den Dateinamen in doppelte Anführungszeichen ein, wenn er Leerzeichen oder Sonderzeichen enthält

 

iBeschreibung

 

kCKSUM-Hashwert (siehe die  Funktion @CKSUM )

 

mMD5-Hashwert (siehe die Funktion @MD5 )

 

qDatei- oder Verzeichnisbesitzer (nur NTFS)

 

rCRC32-Hashwert (siehe die Funktion @CRC32 )

 

sStreamnamen (nur NTFS)

 

spPfad- und Streamnamen als Pfadname+Dateiname+Streamname (nur NTFS)

 

t[...]Uhrzeit (Sie müssen mindestens ein Unterfeld angeben, sonst bleibt das Feld leer)
hStunden (2 Ziffern, führende Null)
mMinuten (2 Ziffern, führende Null)
sSekunden (2 Ziffern, führende Null)
dmilliseconds (Dezimaltrennzeichen und 3 Ziffern)
z[...]Größe
aZugewiesene 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.
cDie 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_dirsDie Anzahl der erstellten Verzeichnisse
%_pdir_filesDie Anzahl der verschobenen Dateien
%_pdir_errorsDie 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.

 

/\Anzeige von Verzeichnisnamen mit einem nachgestellten \.

 

/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.

 

/BUnterdrücken Sie die Kopf- und Zusammenfassungszeilen und zeigen Sienur dieDatei- oder Unterverzeichnisnamen in einer einzigen Spalte an. Diese Option ist besonders nützlich, wenn Sie eine Liste von Namen an eine Datei oder ein anderes Programm weiterleiten wollen. Wenn Sie/B zusammen mit /Sverwenden , zeigt PDIR den vollständigen Pfad jeder Datei an, anstatt nur den Namen und die Erweiterung. Wenn Sie/B mit /X auf einem LFN-Laufwerk verwenden, zeigt PDIR den kurzen Namen jeder Datei anstelle des langen Namens an. Mit/B wird auch /H gesetzt .

 

/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.

 

/DDie Verzeichnisliste wird nicht eingefärbt. Siehe DIR für weitere Informationen zur Einfärbung von Verzeichnissen.

 

/HZeigt die"." und".." Verzeichnisnamenan(normalerweise unterdrückt).

 

/HLHarte Links anzeigen.

 

/I "text"Wählt Dateinamen anhand des Textes in ihren Beschreibungen aus. Siehe Beschreibungsbereiche für Details.

 

/KZeigt die Kopfzeile (Laufwerks- und Verzeichnisnamen) an.

 

/MZeigt die Fußzeile (Datei- und Byteanzahl) an.

 

/NSchaltet die angegebenen Optionen aus.

 

dVersteckte Verzeichnisse überspringen (bei Verwendung mit /S)
eFehler nicht anzeigen
fFreie Bytes in der Fußzeile unterdrücken
hUnterdrücke den Header
jAbzweigungen überspringen (bei Verwendung mit /S)
lLink-Namen für symbolische Links nicht anzeigen
m:nMaximal n Verzeichniseinträge anzeigen
sUnterdrücke die Fußzeile
vUnterdrücke die Datenträgerbezeichnung in der Kopfzeile
zSystemverzeichnisse überspringen (bei Verwendung mit /S)

 

/O...DieSortierreihenfolge wird auf die Einträge jedes Unterverzeichnisses separat angewendet. Jede Kombination der Sortieroptionen kann verwendet werden. Wenn mehrere Optionen angegeben werden, wird die Liste nach der ersten Sortieroption als Primärschlüssel sortiert, die nächste als Sekundärschlüssel usw.

 

nNach 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
aSortiert Namen und Erweiterungen in der Standard-ASCII-Reihenfolge, anstatt numerisch zu sortieren, wenn Ziffern im Namen oder in der Erweiterung enthalten sind.
cSortieren nach Kompressionsverhältnis (die am wenigsten komprimierte Datei in der Liste wird zuerst angezeigt).
dSortieren nach Datum und Uhrzeit (älteste Datei zuerst); siehe auch /T:acw
eSortieren nach Erweiterung
gErst Unterverzeichnisse, dann Dateien gruppieren
iNach Dateibeschreibung sortieren (wird ignoriert, wenn  auch/C oder /O:c verwendet wird).
oNach Eigentümer sortieren
rUmkehrung der Sortierreihenfolge für alle Optionen
sSortieren nach Größe
t Gleich wied
uUnsortiert
xKombiniert 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.

 

/QZeigt den Eigentümer der Datei an.

 

/SZeigt 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 .

 

/T:type Legt fest, welches der unten aufgeführten Datums- und Zeitfelder, die auf einem Laufwerk verfügbar sind, das lange Dateinamen unterstützt, angezeigt und für die Sortierung verwendet werden soll:

 

aDatum und Uhrzeit des letzten Zugriffs (NTFS-Volumes).
cErstellungsdatum und -uhrzeit.
wDatum 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.

 

/(...)Verwenden Sie diese Option, um die verschiedenen Felder und Anzeigeformate zu definieren, die Sie für jeden ausgewählten Eintrag verwenden möchten. Die Felder können in beliebiger Reihenfolge stehen und sich wiederholen. Wenn diese Option nicht verwendet wird, ist das Ausgabeformat identisch mit dem des  DIR-Befehls. Wenn Sie mehrere  Optionen/(...) angeben , fügt PDIR zwischen den einzelnen Optionen ein Leerzeichen in die Ausgabe ein.