Zeitplanvariablen abrufen
Zeitplanvariablen abrufen
Ruft Objekte vom Typ "Zeitplan" ab. Dabei kann sowohl die Quelle angegeben werden (entweder ein DSM Objekt, das eine Zeitplan-Eigenschaft oder eine Zeitplan-Variable besitzt oder ein anderes Zeitplan-Objekt) sowie das zu verwendende Format angegeben werden.
Beispiele:
Hinweis: Voraussetzung für die Beispiele ist ein verbundenes PowerShell-Laufwerk. |
Im ersten Beispiel wird der Wert "Wartungszeitfenster" der Eigenschaftengruppe "Wartungsplan" des Computer "WIN10-01" abgerufen. Dies ist die Standard-Eigenschaft dieses Datentyps und daher muss diese nicht explizit angegeben werden:
$MyComputer = Get-EmdbComputer "WIN10-01" -Recurse Get-EmdbSchedule -Item $MyComputer -Format DisplayTable |
Der Wert des Format-Parameters kann dabei die in der folgenden Tabelle genannten Werte annehmen:
<Format> |
Darstellung |
Entspricht |
PassThru |
Wert als [EmdbTimeTable] Objekt |
$MySchedule |
String |
Wert als Zeichenfolge (wie in DSM-Datenbank) |
$MySchedule.ToString(), $MySchedule.ToString("S“) |
DisplayTable |
Wert als Tabelle dargestellt (wie in DSM-Protokollen) |
$MySchedule.ToDisplayString("All", [DateTime]::Now, $null, $true, $null), $MySchedule.ToString("TFM“) |
Hashtable |
Wert als Hashtable |
$MySchedule.ToHashtable() |
Wenn Sie den Wert einer Eigenschaft oder einer Variablen eines DSM-Objekts vom Typ "Zeitplan" direkt abrufen, so erhalten Sie den Wert, wie er in der DSM-Datenbank gespeichert ist, nämlich einen String-Wert. Um diesen in ein Objekt vom Typ "Zeitplan" mit dem gewünschten Format zu konvertieren, gehen Sie folgendermaßen vor:
$MyComputer = Get-EmdbComputer "WIN10-01" -Recurse $MyScheduleString = $MyComputer.GetVariableValue("Schedule") $MySchedule = Get-EmdbSchedule -Schedule $MyScheduleString -Format HashTable |
Für das Format String kann zusätzlich ein Parameter Options mit Formatoptionen für die Zeichenfolge angegeben werden.
Get-EmdbSchedule -Item <Objekt> -Format String -Options <Formatoptionen> |
Die Formatoptionen können dabei wie in der folgenden Tabelle aufgelistet angegeben werden.
<Formatoption> |
Wirkung |
S |
Wert als Zeichenfolge (wie in DSM-Datenbank) |
T, TA |
Wert als Tabelle dargestellt (wie in DSM-Protokollen) – gilt auch für alle weiteren Formatoptionen |
TW |
Wert als Tabelle – nur Wochenplan |
TY |
Wert als Tabelle – nur Jahresplan |
M |
Aktueller Tag bzw. aktuelle Stunde ist markiert (wie in DSM-Protokollen: [X] ) |
M(<Datum/Zeit>) |
Der angegebene Zeitpunkt (Tag / Stunde) ist markiert |
F |
Vollständige Namen für Wochentage und Monate |
L(<Sprache/Kultur>) |
Namen für Wochentage und Monate werden in der angegebenen Sprache angezeigt. |
C(<Aktiv><Inaktiv><Benutzer kann aktivieren><Benutzer kann deaktivieren>) |
Verwendete Zeichen für die Darstellung der Aktivierung. Standard wäre „C(YNyn)“ |
Die Formatoptionen sind kombinierbar – Beispiel:
Get-EmdbSchedule -Schedule $MySchedule -Format String -Options "TFML(de)C(JNjn)" |