5.5. Modifier des messages existants

Maintenant que nous avons créé des messages, cela vaut la peine de voir ce que nous pouvons en faire par la suite.

5.5.1. Réactiver un message existant IDERI note

Parfois, vous avez déjà un message existant avec du contenu à réutiliser et vous ne voulez pas qu’un nouveau message soit créé à chaque fois que vous souhaitez informer les destinataires du message. Au lieu de cela, vous voudrez peut-être réactiver le message IDERI note en changeant son heure de début et de fin. Pour cela, nous pouvons utiliser la CmdLet Enable-iNoteMessage ou son alias Restart-iNoteMessageRevision.

PS> Enable-iNoteMessage -Index 4 -EndTime (Get-Date).AddHours(1) -Force

La commande dans l’ exemple ci-dessus crée une nouvelle révision du message IDERI note avec l’index 4 et définit son heure de début sur l’heure actuelle. De plus, nous avons défini une nouvelle heure de fin d’une heure à partir de maintenant. Le paramètre ‘-Force’ exécutera la commande sans demander de confirmation.

5.5.2. Annuler un message existant IDERI note

Pour annuler un message existant, nous pouvons utiliser le Disable-iNoteMessage CmdLet ou son alias Stop-iNoteMessage.

PS> Disable-iNoteMessage -Index 4 -Force

La commande dans l’ exemple ci-dessus crée une nouvelle révision de message du message IDERI note avec l’index 4 et définit son heure de début et de fin sur l’heure actuelle afin que le message ne soit plus valide et disparaisse des bureaux des destinataires.

5.5.3. Créer une nouvelle révision d’un message existant

Si nous voulons changer un existant message IDERI note entièrement en attribuant un nouveau texte, une heure de début et de fin et quelques autres propriétés, nous pouvons utiliser le CmdLet Set-iNoteMessage. Le processus est assez similaire à celui décrit dans le chapitre 5.4.2: Nous devons d’abord définir un nouvel objet message qui a toutes les propriétés souhaitées suivi de l’exécution de Set-iNoteMessage afin de créer la nouvelle révision des messages IDERI note.

PS> $MsgObj = Get-iNoteMessage -Index 2
PS> $MsgObj.Text = "Texte modifié pour la nouvelle révision."
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 = "A link to iderinote.com"
PS>
PS> Set-iNoteMessage -MessageObject $MsgObj -Index 4


Index                  : 4
RevisionIndex          : 2
Text                   : Texte modifié pour la nouvelle révision.
Priority               : Information
StartTime              : 8/3/2023 8:38:11 AM
EndTime                : 8/3/2023 10:38:11 AM
LinkText               : A link to 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

Dans l’ exemple ci-dessus, nous interrogeons d’abord le message avec l’index 2 du serveur et l’enregistrons dans une variable objet nommée $MsgObj. Ensuite, nous modifions certaines de ses propriétés comme le texte, l’heure de début et de fin, le lien et l’accusé de réception. Toutes les autres propriétés de l’ancien message seront conservées. Ensuite, nous exécutons Set-iNoteMessage et spécifions notre objet en tant que paramètre. Nous fournissons également à la CmdLet l’index du message que nous souhaitons modifier. La révision du message IDERI note sera renvoyée à la suite de cette opération.