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)"