GetFileAgesValue

Beschreibung

Liefert Ihnen den zugewiesenen Speicherplatz oder die Größe und Anzahl der Dateien für eines der „Verteilungen“ Balkendiagramme.

Syntax

GetFileAgesValue (FolderID : <Integer>, Index : <Shortint>, [out]OccupiedSize : <OLEVariant>, [out]NumFiles : <OLEVariant>)

Parameter

OrdnerID

Die ID, die auf das Verzeichnis verweist, für das die „Age of Files“-Werte abgerufen werden sollen. Sie erhalten diese ID über die Funktionen RootFolderID, FirstChildID oder NächsteGeschwisterID.

Index

Der Index der Leiste „Dateialter“, die exportiert werden soll. Der erste Index ist immer 0. Der letzte Index ist immer (FileAgesCount-1).

[out]BelegteGröße

(Out-Parameter) Der von allen Dateien dieses „Dateialter“-Intervalls belegte Platz. Standardmäßig gibt der Wert den zugewiesenen Speicherplatz zurück. Um die tatsächliche Größe zu ermitteln, muss die Option ViewType auf „2“ gesetzt werden (siehe Beispiel unten).

[out]NumFiles

(Out-Parameter) Die Anzahl der Dateien dieses „Dateialter“-Intervalls.

Beispiel

1.)

PowerShell:

$RootDirectoryID = $SOS.RootFolderID
$SOS.SizeUnit = "MB"
for(($Index = 0); ($Index -lt $SOS.FileAgesCount); ($Index++))
{
    $SOS.GetFileAgesValue($RootDirectoryID, $Index, $AllocatedSpace, $NumberOfFiles)
    ...
}

VBS:

RootDirectoryID = SOS.RootFolderID
SOS.SizeUnit = "MB"
Index = 0
Do While Index<SOS.FileAgesCount
    SOS.GetFileAgesValue RootDirectoryID, Index, AllocatedSpace, NumberOfFiles
    ...
    Index = Index+1
Loop

Durchläuft alle „Age of Files“-Intervalle des aktuell aktivierten Stammverzeichnisses und fragt für jedes einzelne Intervall den zugewiesenen Speicherplatz in MB und die Anzahl der Dateien ab.

2.)

PowerShell:

$RootDirectoryID = $SOS.RootFolderID
$SOS.SizeUnit = "Bytes"
$SOS.SetOptions("ViewType", "2") #2 = Real size, 3 = Allocated size (default)
for(($Index = 0); ($Index -lt $SOS.FileAgesCount); ($Index++))
{
    $SOS.GetFileAgesValue($RootDirectoryID, $Index, $AllocatedSpace, $NumberOfFiles)
    ...
}

VBS:

RootDirectoryID = SOS.RootFolderID
SOS.SizeUnit = "Bytes"
SOS.SetOption "ViewType", "2" ' 2 = Real size, 3 = Allocated size (default)
Index = 0
Do While Index<SOS.FileAgesCount
    SOS.GetFileAgesValue RootDirectoryID, Index, AllocatedSpace, NumberOfFiles
    ...
    Index = Index+1
Loop

Durchläuft alle „Age of Files“-Intervalle des aktuell aktivierten Stammverzeichnisses und fragt für jedes einzelne Intervall die Größe in Bytes und die Anzahl der Dateien ab.