2.5. Les outils de ligne de commande IDERI note¶
Les outils de ligne de commande IDERI note (IDERI note Command Line Tools) se composent de deux applications en mode console que vous pouvez utiliser pour automatiser la création et la suppression des messages IDERI note, inotecmd.exe et inotedel.exe. En utilisant inotecmd.exe, vous pouvez créer de nouveaux messages ou mettre à jour des messages existants. En utilisant inotedel.exe, vous pouvez supprimer les messages existants.
La syntaxe de ligne de commande de inotecmd.exe est la suivante :
INOTECMD.EXE Message Starttime Endtime Recipients Priority Server <Options>
Message correspond au texte du message. Vous pouvez incorporer des variables d’environnement dans ce texte, elles seront développées lors de l’exécution. Pour créer une nouvelle ligne dans le texte, ajoutez \n à l’emplacement où vous souhaitez que la nouvelle ligne démarre, un peu comme dans la syntaxe de script. Starttime est l’heure de début du message et doit être spécifié au format suivant : « MM/JJ/AAAA hh:mm:ss ». Endtime est l’heure de fin du message et doit être spécifié dans le format suivant : « MM/JJ/AAAA hh:mm:ss » Dans les deux cas, MM désigne le mois (dans la plage 1 ... 12), DD le jour (dans la plage 1 ... 31), YYYY l’année sous la forme d’un nombre à quatre chiffres, hh l’heure (dans la plage 0 ... 23), mm les minutes (dans la plage 0 ... 59) et ss les secondes (0 ... 59). L’heure de début et l’heure de fin du message peuvent être spécifiées en utilisant une heure relative au lieu d’une heure absolue en utilisant le format « +dd/hh/mm/ss » (heure relative future) ou le format «-dd/hh/mm/ss » (heure relative dans le passé). Les noms de destinataires doivent être séparés par des virgules et doivent être spécifiés dans la notation domaineutilisateur. La priorité doit être INFORMATION, AVERTISSEMENT ou ALERTE et et le serveur est le serveur IDERI note où le message est ajouté ou modifié. La table Options de ligne de commande pour inotecmd.exe répertorie les options de ligne de commande inotecmd.exe.
| Option de ligne de commande | Explications |
|---|---|
| -tcp=TCP-Port/AD | Utiliser le port TCP fourni ou le résultat de la requête AD pour appeler le serveur |
| -r | Créer un message avec accusé de réception |
| -a | Créer un message avec accusé de lecture |
| -uc | Ne pas envoyer de message si accusé de réception sur le même client |
| -uo | Ne pas envoyer de message si accusé de réception sur d’autres clients |
| -ua | Ne pas envoyer de message si l’utilisateur s’est connecté localement après l’heure de début du message |
| -u=username | Nom d’utilisateur pour les informations d’identification alternatives |
| -d=domainname | Nom de domaine pour les informations d’identification alternatives |
| -p=password | Mot de passe pour les informations d’identification alternatives |
| -wg | Ouverture de session de style groupe de travail |
| -w=0|1 | Afficher le message dans la fenêtre de message (la valeur par défaut est 1) |
| -t=0|1 | Afficher le message dans la bannière défilante (la valeur par défaut est 0) |
| -ad | Récuperer le nom de serveur via une requête AD |
| -rs | Les destinataires et exclusions des messages sont sont spécifiés en tant que SID |
| -i=Index | Met à jour un message existant au lieu de créer un nouveau message |
| -n=x | Informer immédiatement les destinataires (“Push”)
x=0: afficher uniquement les SID
x=1: résoudre les SID sur le client (groupe travail)
x=2: résoudre les SID localement (domaines)
|
| -l | Envoyer également un message sur l’écran de connexion |
| -lo | Envoyer un message uniquement sur l’écran de connexion |
| -lx=text | Spécifier le texte à afficher |
| -la=target | Spécifier le lien hypertexte |
| -lm=0|1 | Afficher le lien en plein écran (la valeur par défaut est 0) |
| -ls | Laisser le descripteur de sécurité existant intact et ignorer les destinataires et les exclut. Fonctionne uniquement lors de la mise à jour d’un message. Si cette option est spécifiée, les destinataires et les listes d’exclusion spécifiés sur la ligne de commande seront ignorés (et peuvent donc être vides) et les informations de sécurité existantes du message seront utilisées. Ceci est utile pour mettre à jour uniquement le texte ou la catégorie d’un message, sans changer les destinataires, et exclut toute autre information de sécurité du message. |
| -e=excludes | Exclut les utilisateurs et les groupes de la réception des messages (liste séparée par des virgules, spécifiez en notation domaineutilisateur ou en tant que SID avec l’option de ligne de commande -rs). Les variables d’environnement (telles que %USERDOMAIN%%USERNAME% ) sont résolues par inotecmd.exe lui-même. |
| -s | Simuler la création de messages et afficher toutes les informations de diagnostic |
| -hoe | Exclure les utilisateurs en télétravail |
| -hoo | Envoyer uniquement aux utilisateurs en télétravail |
| -am=x | Mode d’adressage
x=0: Envoyer un message uniquement aux utilisateurs
(valeur par défaut)
x=1: Envoyer un message aux utilisateurs/ordinateurs
x=2: Envoyer un message uniquement aux ordinateurs
|
| -nr=networkranges | Spécifie les plages réseau sous forme d’ID séparés par des virgules |
| -nre | Exclure les plages réseaux de la distribution des messages |
| -fs | Afficher le message en mode plein écran |
| -fse | Afficher le message en mode plein écran et verrouiller le poste de travail |
| -mo | Send message to mobile devices only. |
| -me | Exclude mobile devices from the recipients. |
| -lang_langspec=language text | Texte pour la langue langspec 1 |
| -la_langspec=language link target | Cible de lien pour la langue langspec 1 |
| -lx_langspec=language link text | Texte du lien pour la langue langspec 1 |
| -??? | Afficher les informations d’utilisation détaillées |
Footnotes
| [1] | (1, 2, 3) les identifications langspec language sont des identifications de langues conformes à l’ISO 639-1 tels que “en-US” pour anglais (États-Unis) ou “pt-BR” pour portuguais (Brésilien) |
Exemples de ligne de commande (les sauts de ligne en ligne de commande sont uniquement spécifiés ici pour une bonne lisibilité) :
INOTECMD.EXE "Service on %COMPUTERNAME% is down at %DATE% %TIME%" "+0"
"+24/00/00" "MyDomain\ServiceAdmins" ALERT SRV01 -r -a
Cela va créer une alerte avec “le nom de l’ordinateur”, “la date”, “l’heure actuelle” dans le texte qui est désormais valable pendant 24 heures et sera envoyée au groupe AD MyDomainServiceAdmins avec des accusés de réception et de lecture. Le serveur IDERI note est l’ordinateur portant le nom SRV01.
INOTECMD.EXE "Hello World" "12/23/2008 17:01:22" "12/01/2009 11:09:45"
"Everyone" INFORMATION INOTESRV.TROUT.LOCAL -u=Goof -d=TROUT
-p=MyPassword
Cela va créer un message d’information envoyé à chaque utilisateur avec le texte “Hello World”. ». Le message sera valable du 23 décembre 2008 17:01:22 jusqu’au 01 décembre 2009 11:09:45. Le créateur est l’utilisateur Goof du domaine TROUT qui a le mot de passe MyPassword. Le serveur IDERI note est INOTESRV.TROUT.LOCAL
La syntaxe de ligne de commande de inotedel.exe est la suivante :
INOTEDEL.EXE server message-index [options]
Le serveur est le serveur IDERI note où le message est supprimé et l’index des messages est l’index numérique du message à supprimer. Les options suivantes peuvent être utilisées :
Le tableau Options de ligne de commande pour inotedel.exe répertorie les options de ligne de commande inotedel.exe.
| Option de ligne de commande | Explications |
|---|---|
| -u=username | nom d’utilisateur pour les informations d’identification alternatives |
| -d=domainname | nom de domaine pour les informations d’identification alternatives |
| -p=password | mot de passe pour les informations d’identification alternatives |
| -tcp=TCP-Port/AD | utilise le port TCP fourni ou le résultat de la requête AD pour appeler le serveur |
| -ad | nom du serveur via la requête AD |
Attention
** Adressage du compte d’ordinateur Active Directory du serveur IDERI note**
Si vous exécutez un environnement IDERI note avec un mode de licence “Professionnel” et si un client IDERI note s’éxécute sur l’ordinateur du serveur IDERI note pour les utilisateurs connectés de manière interactive sur cet ordinateur, les spécificités de la section 7.6.4 s’appliquent. Les outils de ligne de commande IDERI note, contrairement aux outils GUI tels que l’administrateur IDERI note, n’essaieront pas d’appliquer l’heuristique décrite dans cette section pour convertir comme par magie le nom de compte d’ordinateur Active Directory® du serveur IDERI note en NetworkService. Si vous souhaitez adresser le compte d’ordinateur Active Directory® du serveur IDERI note, vous devez fournir le nom de compte du service réseau sur la ligne de commande inotecmd.exe ou sa chaîne SID («S-1-5-20») lors de l’utilisation du paramètre de ligne de commande -rs.