5.5. Bestehende Nachrichten ändern¶
Nun, da wir einige Nachrichten erzeugt haben, können wir den weiteren Umgang damit vertiefen.
5.5.1. Reaktivierung einer bestehenden IDERI note Nachricht¶
In manchen Situationen möchte man eine bestehenden Nachricht wiederverwenden, um die Benutzer zu informieren, ohne dabei eine komplett neue Nachricht zu erzeugen. Stattdessen möchte man lieber die IDERI note Nachricht reaktivieren, indem man nur ihren Start- und Endezeitpunkt anpasst. Zu diesem Zweck verwendet man das CmdLet Enable-iNoteMessage oder seinen Alias Restart-iNoteMessageRevision.
PS> Enable-iNoteMessage -Index 4 -EndTime (Get-Date).AddHours(1) -Force
Das Kommando im obigen Beispiel erzeugt eine neue Revision der IDERI note Nachricht mit dem Nachrichtenindex 4 und setzt dabei den Startzeitpunkt auf die aktuelle Uhrzeit. Weiterhin wird der Endezeitpunkt der Nachricht auf eine Stunde von jetzt an gesetzt. Der Parameter ‘-Force’ führt das Kommando ohne Abfrage einer weiteren Bestätigung aus.
5.5.2. Zurückziehen einer existierenden IDERI note Nachricht¶
Um eine existierende Nachricht zurückzuziehen, kann das CmdLet Disable-iNoteMessage oder sein Alias Stop-iNoteMessage verwendet werden.
PS> Disable-iNoteMessage -Index 4 -Force
Das Kommando im obigen Beispiel legt eine neue Revision der IDERI note Nachricht mit dem Nachrichtenindex 4 an und setzt sowohl den Startzeitpunkt als auch den Endezeitpunkt der Nachricht auf die aktuelle Uhrzeit. Damit ist die Nachricht nicht mehr gültig und verschwindet so vom Bildschirm der Empfänger.
5.5.3. Anlegen einer neuen Revision bei einer existierenden IDERI note Nachricht¶
Soll eine existierende IDERI note Nachricht dahingehend geändert werden, dass ihr ein neuer Text, neue Start- und Endezeitpunkte und weitere Eigenschaften zugewiesen werden, kann das CmdLet Set-iNoteMessage zum Einsatz kommen. Dazu muss zunächst ein neues Nachrichtenobjekt mit den gewünschten Eigenschaften definiert werden und anschliessend Set-iNoteMessage ausgeführt werden, um die neue Revision der IDERI note Nachricht anzulegen.
PS> $MsgObj = Get-iNoteMessage -Index 2
PS> $MsgObj.Text = "Geänderter Text für die neue Revision."
PS> $MsgObj.StartTime = (Get-Date)
PS> $MsgObj.EndTime = (Get-Date).AddHours(2)
PS> $MsgObj.NotifyReceive = $true
PS> $MsgObj.LinkTarget = "https://www.iderinote.com"
PS> $MsgObj.LinkText = "Eine Verknüpfung zu iderinote.com"
PS>
PS> Set-iNoteMessage -MessageObject $MsgObj -Index 4
Index : 4
RevisionIndex : 2
Text : Geänderter Text für die neue Revision.
Priority : Information
StartTime : 8/3/2023 8:38:11 AM
EndTime : 8/3/2023 10:38:11 AM
LinkText : Eine Verknüpfung zu iderinote.com
LinkTarget : https://www.iderinote.com
ShowLinkMaximized : False
Recipient : {NOTE\eva.smith, NOTE\albert.tross, NOTE\Arno.Nym}
Exclude : {}
AddressingMode : UserOnly
ShowPopup : True
ShowTicker : False
ShowFullscreen : False
ShowFullscreenAndLock : False
NotifyReceive : True
NotifyAcknowledge : False
ShowOnWinLogon : False
ShowOnWinLogonOnly : False
HomeOfficeUsersOnly : False
HomeOfficeUsersExclude : False
RevisionCreated : 8/3/2023 8:38:24 AM
RevisionUpdater : NOTE\adam.sam
Im obigen Beispiel ist ersichtlich, dass die Nachricht mit dem Nachrichtenindex 2 zuerst vom Server ermittelt wird und in einer Variablen mit Namen $MsgObj gespeichert wird. Im Anschluss werden einige Eigenschaften, wie etwa der Nachrichtentext, Start- und Endezeitpunkt, die Verknüpfungsinformationen sowie die Nachrichtenoption NotifyReceive geändert. Alle übrigen Eigenschaften der seitherigen Nachricht werden beibehalten. Daraufhin wird Set-iNoteMessage unter Verwendung dieses Objekt aufgerufen. Dem CmdLet wird ausserdem der Nachrichtenindex der zu verändernden Nachricht übergeben. Die dabei neu erzeugte Revision der Nachricht wird anschliessend als Resultat dieser Operation zurückgegeben.