Vous êtes déjà client NinjaOne ? Connectez-vous pour consulter d'autres guides et les dernières nouvelles.

Interface en ligne de commande (CLI) : Champs personnalisés et script de documentation

  • Dernière mise à jour avril 8, 2026

Sujet

Cette documentation explique comment utiliser le composant ninjarmm-cli pour les systèmes d'exploitation Microsoft Windows, Apple macOS et Linux.

Environnement

  • NinjaOne Endpoint Management
  • Documentation NinjaOne

Description

Le composant ninjarmm-cli est un fichier exécutable qui vous permet d'accéder à des champs personnalisés et à des données de documentation spécifiques et d'interagir avec eux à partir de l'interface de ligne de commande (CLI), du terminal ou de scripts personnalisés.

Sélectionnez une catégorie pour en savoir plus :

Remarques importantes

Avant d'utiliser ninjarmm-cli, vous devez tenir compte des éléments suivants :

  • Les champs sécurisés sont en écriture seule pour les champs de documentation.
  • Vous pouvez lire ou écrire des données de documentation dans l'interface CLI ou dans des scripts personnalisés. Vous pouvez générer une liste de modèles, une liste de documents par nom de modèle ou numéro d'identification, ainsi que la valeur de chaque champ d'un document.
    • L'interface CLI ou les scripts personnalisés ne peuvent accéder qu'aux modèles et aux documents contenant au moins un champ rempli. Les modèles et les documents vides ne s'affichent pas.
  • Vous pouvez utiliser des scripts personnalisés écrits en Batch ou PowerShell pour Windows, ou en ShellScript pour macOS et Linux. Étant donné que ninjarmm-cli.exe réside dans un dossier protégé inaccessible aux utilisateurs normaux, vous devez exécuter tout script utilisant cette fonctionnalité en tant que système, ou modifier les autorisations en conséquence.
  • Pour les appareils Linux, vous devez ajouter ./ devant ninjarmm-cli dans le terminal pour exécuter correctement la commande.
  • Pour les appareils Windows, si vous devez stocker la sortie de la commande ninjarmm-cli get dans une variable, vous pouvez utiliser le paramètre facultatif --direct-out pour forcer l'utilisation du canal de sortie standard stdout au lieu des fonctions API Windows telles que WriteConsoleW/WriteFile. Cependant, cela peut entraîner la perte de la prise en charge de la sortie Unicode, qui ne fonctionne pas correctement sur certaines versions de Windows avec le canal stdout. Reportez-vous à l'exemple suivant de cette commande :
 ninjarmm-cli --direct-out get [nom du champ]

Accès aux champs sécurisés via les automatisations

Vous ne pouvez pas dépasser 200 caractères pour les champs sécurisés.

Toute automatisation que vous exécutez à partir de la bibliothèque d'automatisation peut accéder aux champs sécurisés, qui comprennent :

  • Conditions de script
  • Conditions composées de script
  • Tâches planifiées par politique
  • Tâches planifiées globales
  • Exécuter avant les actions de sauvegarde, de correction, d'installation de l'application et autres tâches similaires
  • Exécuter après les actions de sauvegarde, de correction, d'installation de l'application et autres tâches similaires
  • Actions d'automatisation sur des conditions
  • Exécuter l'automatisation

Voici quelques points importants à noter concernant les champs sécurisés :

  • NinjaOne ne fournit l'accès aux champs personnalisés sécurisés que pendant l'exécution de l'automatisation.
  • Le terminal web ou le terminal local ne peut pas accéder aux champs personnalisés sécurisés.
  • Seules les commandes exécutées sur un appareil local à l'initiative de NinjaOne peuvent accéder aux champs personnalisés, y compris les opérations GET et SET, les champs sécurisés personnalisés et les champs sécurisés de documentation. Cependant, les champs sécurisés de documentation utilisent uniquement les opérations SET via l'interface CLI.

Interaction avec les champs personnalisés via l'interface CLI ou le terminal Windows

L'agent décompresse automatiquement cet exécutable dans les dossiers suivants :

  • Windows : C:ProgramDataNinjaRMMAgentninjarmm-cli.exe
  • macOS : /Applications/NinjaRMMAgent/programdata/ninjarmm-cli
  • Linux : /opt/NinjaRMMAgent/programdata/ninjarmm-cli

Pour Windows, utilisez la variable d'environnement spéciale suivante au niveau du système :

  • Windows : %NINJARMMCLI%pourC:ProgramDataNinjaRMMAgentninjarmm-cli.exe
  • Linux : $NINJA_DATA_PATH/ninjarmm-cli set $fieldname $variable

La CLI NinjaRMM ressemble à l'exemple Windows suivant :

c:ProgramDataNinjaRMMAgentninjarmm-cli.exe help

ninjarmm-cli - Outil CLI permettant d'accéder aux champs personnalisés de NinjaRMM Agent et de les gérer.
Utilisation :
  help - afficher ce texte

Champs globaux et de rôle :

get <nom de l'attribut> - obtenir la valeur de l'attribut avec le nom spécifié

set <nom de l'attribut> <valeur de l'attribut et liste de valeurs séparées par des virgules> - définir la valeur de l'attribut spécifié
   --stdin - modificateur facultatif pour utiliser les données redirigées. Par exemple : dir | %NINJARMMCLI% set --stdin myfield

options <nom de l'attribut> - obtenir la liste des valeurs valides pour le nom de l'attribut (réel pour les attributs déroulants et à sélection multiple)

Champs de documentation :

templates - obtenir une liste des modèles qui contiennent des documents et des attributs
   --ids, --names - modificateurs facultatifs

documents « <id/nom du modèle> » - obtenir la liste des documents pour le modèle par id ou nom (guillemets obligatoires)
   --ids, --names - modificateurs facultatifs

get « <id/nom du modèle> » « <nom du document> » <nom de l'attribut> - obtenir l'attribut du document par nom de document et id/nom du modèle (guillemets obligatoires)

get "<nom du modèle unique>" <nom de l'attribut> - obtenir l'attribut d'un document unique par nom de modèle (guillemets obligatoires)

org-set "<id/nom du modèle>" "<nom du document>" <nom de l'attribut> "<valeur de l'attribut et liste de valeurs séparées par des virgules>" - définir l'attribut pour le document/attribut spécifié par nom de document et id/nom du modèle (guillemets obligatoires)

org-set « <nom du modèle unique> » <nom de l'attribut> « <valeur de l'attribut et liste de valeurs séparées par des virgules> » - définir l'attribut pour un document/attribut unique par nom de modèle (guillemets obligatoires)

org-clear « <identifiant/nom du modèle> » « <nom du document> » <nom de l'attribut> - effacer la valeur du document par nom de document et identifiant/nom du modèle (guillemets obligatoires, représente NULL)

org-clear « <nom du modèle unique> » <nom de l'attribut> - effacer la valeur d'un document unique par nom de modèle (guillemets obligatoires, représente NULL)

org-options "<id/nom du modèle>" "<nom du document>" <nom de l'attribut> - obtenir la liste des valeurs valides pour le nom de l'attribut du document par nom de document et id/nom du modèle (réel pour les attributs déroulants et à sélection multiple)

org-options « <nom du modèle unique> » <nom de l'attribut> - obtenir la liste des valeurs valides pour un nom d'attribut de document unique par nom de modèle (valable pour les attributs déroulants et à sélection multiple)

Format de sortie :

codes de sortie : 0 - Succès, 1 - Erreur

en cas de succès : quitter avec 0 et afficher la valeur

en cas d'erreur :   quitter avec 1 et afficher la description de l'erreur

pour lire le code de sortie : Win : « echo %errorlevel% », Unix : « echo $? »

Types d'attributs :

  CheckBox - Type booléen, valeurs acceptables : 0, 1, true, false

  Numérique - Type entier, valeurs comprises entre -2147483648 et 2147483647, prend en charge les paramètres avancés du filtre d'entrée.

  Décimal - Type flottant, valeurs comprises entre -9999999,999999 et 9999999,999999, prend en charge les paramètres avancés du filtre d'entrée.

  TextMultiLine, Text - chaîne de caractères normale

  TextEmail - chaîne de caractères normale, doit correspondre au format d'adresse e-mail RFC 5322

  TextIpAddress - chaîne de caractères normale, doit correspondre au format IPv4 ou IPv6, prend en charge les paramètres avancés du filtre d'entrée

  TextPhone - chaîne de caractères régulière, doit correspondre au format de numéro de téléphone E.164

  TextEncrypted - chaîne de caractères cryptée régulière, prend en charge les paramètres avancés du filtre d'entrée (en écriture seule pour la documentation)

  DateTime - nombre entier de secondes depuis le début de l'époque Unix ou format ISO « aaaa-MM-jjHH:mm: ss » sans fuseau horaire (UTC)

  Date - nombre entier de secondes depuis le début de l'époque Unix ou format ISO « aaaa-MM-jj »

  Time - nombre entier de secondes ou format ISO « HH:mm:ss »

  MultiSelect - liste d'options uniques (voir la commande <options>)

  MultiSelectNode, MultiSelectClient, MultiSelectClientLocation - (en lecture seule par CLI) données relatives à l'organisation

  Drop-down - une option unique (voir la commande <options>)

  DropdownNode, DropdownClient, DropdownClientLocation - (en lecture seule par CLI) données relatives à l'organisation

  Attachment - (en lecture seule par CLI) objet JSON contenant des informations sur le fichier.

  WYSIWYG - (en lecture seule par CLI) objet JSON contenant du contenu HTML et TEXT

Module PowerShell NinjaOne

Lorsque vous installez l'agent NinjaOne, NinjaOne déploie et charge un module PowerShell NinjaOne personnalisé pour interagir avec les champs personnalisés. Vous pouvez accéder à ninjarmm-cli sur les appareils Windows via ce module PowerShell en appelant simplement les noms de fonction dans PowerShell.

Commandes NinjaOne PowerShell

Les commandes PowerShell que vous pouvez exécuter sont détaillées ci-dessous.

Get-NinjaProperty 

La commande Get-NinjaProperty est une évolution de la commande Ninja-Property-Get d'origine. La fonction Get-NinjaProperty récupère et convertit une valeur de champ personnalisé Ninja en fonction du nom et du type de champ spécifiés.

La commande accepte un nom de champ, un type de propriété et un nom de document facultatif. Lorsque vous fournissez un nom de document, la fonction récupère la valeur de la propriété à partir du document Ninja spécifié. En fonction du type spécifié (par exemple, Date, DateTime, Checkbox, Dropdown, etc.), la fonction convertit la valeur brute en un objet PowerShell approprié. Si le type de propriété nécessite des options supplémentaires telles que des menus déroulants ou des champs à sélection multiple, la fonction récupère ces options et renvoie une valeur conviviale.

Les types pris en charge sont les suivants : pièce jointe, case à cocher, date, date/heure, décimal, liste déroulante des appareils, sélection multiple des appareils, liste déroulante, e-mail, entier, adresse IP, multiligne, sélection multiple, liste déroulante des organisations, liste déroulante des emplacements des organisations, sélection multiple des emplacements des organisations, sélection multiple des organisations, téléphone, sécurisé, texte, heure, WYSIWYG et URL.

La syntaxe est la suivante : Get-NinjaProperty [-Name] <String[]> [[-Type] <String>] [[-DocumentName] <String>] [<CommonParameters>]

Exemples

La récupération d'un menu déroulant de champ personnalisé sans spécifier le type renvoie la valeur GUID de l'option sélectionnée dans le menu déroulant.

powershell1-upscaled.png
Figure 1 : Aucun type de champ spécifié (cliquez pour agrandir)

La récupération d'un champ personnalisé déroulant tout en spécifiant le type de champ personnalisé (déroulant) entraîne le renvoi par la commande de la valeur conviviale visible dans la plateforme au lieu de la valeur GUID.

powershell2-upscaled.png
Figure 2 : Typede champ spécifié (cliquez pour agrandir)

Set-NinjaProperty

La commande Set-NinjaProperty est une évolution de la commande Ninja-Property-Set d'origine. La fonction Set-NinjaProperty définit un champ personnalisé en fonction des paramètres fournis. Lorsqu'un type de champ est spécifié, elle tente de convertir la valeur fournie en une valeur prise en charge par ce champ particulier. Par exemple, lorsqu'un objet DateTime est fourni et que le type « Date » est spécifié, elle convertit l'objet date en un horodatage Unix et définit le champ avec cette valeur.

Elle peut également définir des champs déroulants et à sélection multiple en utilisant les noms de champ plutôt que leurs GUID.

Les types pris en charge sont les suivants : case à cocher, date, date ou date et heure, DateTime, décimal, liste déroulante, e-mail, entier, adresse IP, multiligne, sélection multiple, téléphone, sécurisé, texte, heure, URL et WYSIWYG.

Exemples

Pour définir un champ personnalisé déroulant sans spécifier le type de champ, il faut utiliser la valeur GUID unique de l'option déroulante souhaitée.

powershell3-upscaled.png
Figure 3 : Aucun type de champ spécifié (cliquez pour agrandir)

La configuration d'un champ personnalisé déroulant tout en spécifiant le type de champ comme déroulant vous permet d'utiliser la valeur conviviale affichée dans la plateforme au lieu de la valeur GUID.

powershell4-upscaled.png
Figure 4 : Typede champ spécifié (cliquez pour agrandir)

Les deux commandes, Get-NinjaProperty et Set-NinjaProperty, prennent entièrement en charge Unicode, ce qui vous permet de définir et de récupérer des emojis via ces commandes.

Vous pouvez accéder à des détails et des exemples supplémentaires pour les deux commandes en ouvrant PowerShell sur un appareil sur lequel l'agent NinjaOne est installé et en saisissant :

Get-Help Get-NinjaProperty

Ou

Get-Help Set-NinjaProperty

Toutes les commandes PowerShell NinjaOne d'origine fonctionnent toujours comme prévu initialement. Ces commandes sont les suivantes :

Ninja-Property-Get $AttributeName
Ninja-Property-Set $AttributeName $Value
Ninja-Property-Options $AttributeName
Ninja-Property-Clear $AttributeName

Commandes de documentation

Ninja-Property-Docs-Templates
Ninja-Property-Docs-Names $TemplateId
Ninja-Property-Docs-Names "$TemplateName"
Ninja-Property-Docs-Get $TemplateId "$DocumentName" $AttributeName
Ninja-Property-Docs-Set $TemplateID "$DocumentName" $AttributeName "value"
Ninja-Property-Docs-Get-Single "templateName" "fieldName"
Ninja-Property-Docs-Set-Single "templateName" "fieldName" "new value"
Ninja-Property-Docs-Clear
Ninja-Property-Docs-Options
Ninja-Property-Docs-Clear-Single - effacer la valeur d'un document unique par nom de modèle (guillemets obligatoires, représenté par NULL)
Ninja-Property-Docs-Options-Single - obtenir la liste des valeurs valides pour le nom d'attribut d'un document unique par nom de modèle (réel pour les attributs déroulants et à sélection multiple)

Interagir avec les champs personnalisés via les commandes CLI Windows, les scripts personnalisés par lots, ShellScript sur UNIX ou les scripts personnalisés ShellScript

Les exemples de cette section montrent comment utiliser des commandes et des scripts batch pour des types spécifiques de champs personnalisés. Ils décrivent des appels à ninjarmm-cli sans chemin d'accès complet, mais vous pouvez spécifier le chemin d'accès complet en fonction de votre plate-forme, comme décrit précédemment dans cet article. Il n'y a aucune différence entre les appels à l'utilitaire CLI sur différentes plates-formes.

Horodatage

L'heure est calculée comme suit :

  • Le système se réfère au 1er janvier 1970 à 00:00:00 UTC comme époque Unix.
  • La valeur de la date correspond au nombre de secondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC.Vous pouvez utiliser un outil de conversion d'horodatage pour obtenir cette valeur sous forme de date lisible par l'utilisateur.
  • Si vous définissez la valeur au format ISO, elle sera convertie en secondes à partir du 01/01/1970 en UTC.

Les exemples de cette section montrent comment utiliser les commandes ou les scripts PowerShell pour des types spécifiques de champs personnalisés.

Sélectionnez un sujet pour continuer :

Case à cocher

Pour le champ Case à cocher, la valeur définie doit être soit vrai (1), soit faux (0).

Obtenir :

# obtenir la valeur du champ case à cocher
> ninjarmm-cli get globalcheckbox
0

Définir :

# définir une valeur booléenne pour le champ case à cocher
> ninjarmm-cli set globalcheckbox 0
0
> ninjarmm-cli set globalcheckbox 1
1
> ninjarmm-cli set globalcheckbox true
1
> ninjarmm-cli set globalcheckbox false
0

Date

Pour le champ Date, la valeur définie doit être exprimée en secondes ou au format ISO (Organisation internationale de normalisation) (aaaa-mm-jj en UTC).

Obtenir :

# obtenir la valeur du champ date
> ninjarmm-cli get globaldate
456

Définir :

# définir la valeur du champ Date
> ninjarmm-cli set globaldate 1626875470000

> ninjarmm-cli set testdate 2021-10-15
1634256000

Date/heure

Pour le champ Date/Heure, la valeur définie doit être exprimée en secondes ou au format ISO (aaaa-mm-jj ou hh:mm:ss en UTC).

Obtenir :

# obtenir la valeur du champ date-heure
> ninjarmm-cli get globaldatetime
1626875470000

Définir :

# définir la valeur du champ date-heure
> ninjarmm-cli set globaldatetime 1626875470000
1626875470000

> ninjarmm-cli set testdatetime 2021-10-15T00:00:00
1634256000

Décimal

Pour le champ Décimal, la valeur définie doit être un nombre compris entre -9999999,999999 et 9999999,999999.

Obtenir :

# obtenir la valeur du champ décimal
> ninjarmm-cli get globaldecimal
123,456

Définir :

# définir la valeur du champ décimal
> ninjarmm-cli set typedecimal 1
1

> ninjarmm-cli set typedecimal 1.23
1.23

> ninjarmm-cli set typedecimal 1.23
1.23

> ninjarmm-cli set typedecimal 1.2345678901234567890
1.234567 # tronqué à la précision maximale, il est préférable de ne pas utiliser une valeur plus courte pour éviter les problèmes de conversion de type de données

> ninjarmm-cli set typedecimal 1234567890.1234567890
1234567890,123457

Liste déroulante

Pour le champ Dropdown, la valeur définie doit correspondre exactement à une option valide, soit en utilisant le GUID (Globally Unique Identifier), soit en utilisant le nom du champ tel qu'il apparaît lorsque vous exécutez la commande options.

Options :

# liste des options pour le champ déroulant
> ninjarmm-cli options globaldropdown
333f541e-747e-4a1e-a2e2-a82c1c2f2008=Option2
74a6ffda-708e-435a-86e3-40b67c4f981a=Option1
f1ba449c-fd34-49df-b878-af3877180d17=Option3

Obtenir le GUID par nom d'option :

# recherchez le GUID de l'option par son nom dans le champ déroulant
> ninjarmm-cli options globaldropdown | grep « Option 1 » | awk -F= '{print $1}'
74a6ffda-708e-435a-86e3-40b67c4f981a

Obtenir :

# obtenir la valeur du champ déroulant
> ninjarmm-cli get globaldropdown
74a6ffda-708e-435a-86e3-40b67c4f981a

Définir :

# définir la valeur du champ déroulant
> ninjarmm-cli set globaldropdown f1ba449c-fd34-49df-b878-af3877180d17

E-mail

Obtenir :

# obtenir la valeur enregistrée
> ninjarmm-cli get typeemail
[email protected]

Définir :

# valeurs correctes
> ninjarmm-cli set typeemail [email protected]
[email protected]

> ninjarmm-cli set typeemail [email protected]
[email protected]

# définir des valeurs incorrectes
> ninjarmm-cli set typeemail [email protected]
Erreur : format ou type de valeur incorrect...

Entier

Pour le champ Integer, la valeur définie doit être un entier (un nombre entier sans décimales) compris entre -2147483648 et 2147483647.

Obtenir :

# obtenir la valeur du champ entier
> ninjarmm-cli get globalinteger
456

Définir :

# définir la valeur du champ entier
> ninjarmm-cli set globalinteger 123

Adresse IP

Pour le champ IP, la valeur définie doit être au format IPv4 (Internet Protocol version 4) ou IPv6 (Internet Protocol version 6).

Obtenir :

# obtenir la valeur enregistrée
> ninjarmm-cli get typeipaddress
192.168.1.100

Définir :

# définir les valeurs correctes
> ninjarmm-cli set typeipaddress 255.255.255.255
255.255.255.255

> ninjarmm-cli set typeipaddress 0.0.0.0
0.0.0.0

# définir des valeurs incorrectes
> ninjarmm-cli set typeipaddress 192.168.1.
Erreur : format/type de valeur incorrect...

> ninjarmm-cli set typeipaddress 255.255.255.256
Erreur : format/type de valeur incorrect...

> ninjarmm-cli set typeipaddress 0.-1.0.0
Erreur : format/type de valeur incorrect...

Plusieurs lignes

Obtenir :

# obtenir le champ multiligne
> ninjarmm-cli get globalmultiline
sampletext1

Définir :

# définir le champ texte
> ninjarmm-cli set globalmultiline sampletext2


Définir (alternative) :

# définir le champ de texte avec des données redirigées
> ls -alh | ninjarmm-cli set globalmultiline

NinjaOne prend en charge l'utilisation d'une seule chaîne multiligne si vous utilisez le caractère de contrôle `n (la touche « backtick » ou « backspark » plus la lettre « n »). Le texte doit être saisi dans l'invite de commande sous la forme d'une seule ligne en raison des restrictions de l'interface CLI ou du terminal, et est limité à 10 000 caractères. Vous pouvez également intégrer des espaces en mettant toute la chaîne entre guillemets. Lorsque vous utilisez ces caractères de contrôle, les données s'affichent comme suit :

Ninja-Property-Set multiline « ligne avec espaces'nligne2'nligne3'nvaleurfinale »

multiline
ligne avec espaces
ligne2
ligne3
finalval

La syntaxe par défaut de la commande « Set » est suffisante dans la plupart des cas. Avec la syntaxe par défaut, l'outil « ninjarmm-cli » récupère les données à partir des arguments de la ligne de commande. Mais parfois, cela ne suffit pas et vous devez récupérer les données à partir du canal stdin (entrée standard).

Par exemple, lorsque vous devez définir des données dans le champ de texte multiligne ou que vous souhaitez obtenir la sortie du fichier et la stocker dans le champ. Ou encore, pour éviter la rupture des tabulations ou des espaces dans la sortie formatée d'autres applications.

Pour ce faire, l'outil CLI fournit une syntaxe alternative avec le paramètre --stdin. Ainsi, lorsque vous utilisez cet argument, vous devez fournir les données en tant qu'entrée sur le canal stdin, à l'aide de pipes Unix. Par exemple : dir | ninjarmm-cli set --stdin [mon nom de champ] ou cat /proc/cpuinfo | grep vendor_id | ninjarmm-cli set --stdin [un autre nom de champ]. Les données acheminées seront stockées dans le champ cible si elles remplissent toutes les conditions de type de champ.

Sélection multiple

Options :

# liste des options pour le champ à sélection multiple
> ninjarmm-cli options globalmultiselect
333f541e-747e-4a1e-a2e2-a82c1c2f2008=Option2
74a6ffda-708e-435a-86e3-40b67c4f981a=Option1
f1ba449c-fd34-49df-b878-af3877180d17=Option3

Obtenir le GUID par nom d'option :

# trouver le GUID de l'option par son nom pour le champ à sélection multiple
> ninjarmm-cli options globalmultiselect | grep « Option 1 » | awk -F= '{print $1}'
74a6ffda-708e-435a-86e3-40b67c4f981a

Définir :

# définir plusieurs valeurs pour le champ à sélection multiple, séparées par des virgules
> ninjarmm-cli set globalmultiselect 333f541e-747e-4a1e-a2e2-a82c1c2f2008,74a6ffda-708e-435a-86e3-40b67c4f981a

Obtenir :

# obtenir les valeurs pour le champ à sélection multiple
> ninjarmm-cli get globalmultiselect
333f541e-747e-4a1e-a2e2-a82c1c2f2008, 74a6ffda-708e-435a-86e3-40b67c4f981a

Numéro de téléphone

Obtenir :

# obtenir la valeur stockée
ninjarmm-cli get typephone
+1234567890

Définir :

# définir les valeurs correctes
> ninjarmm-cli set typephone +77013273916
+77013273916

> ninjarmm-cli set typephone 123456789012344567
123456789012344567

> ninjarmm-cli set typephone +123456789012344567
+123456789012344567

# définir des valeurs incorrectes
> ninjarmm-cli set typephone 14953273916qwerty
Erreur : format/type de valeur incorrect...

> ninjarmm-cli set typephone 1234567890123445678 # trop long
Erreur : format/type de valeur incorrect...

> ninjarmm-cli set typephone ++123456789012344567
Erreur : format/type de valeur incorrect...

Sécurisé

Pour empêcher l'affichage des valeurs des champs sécurisés dans la sortie du script pour les appareils Windows, le script doit contenir @echo off et @echo on autour du code qui appelle %NINJARMMCLI% set [nom du champ sécurisé] [valeur sécurisée]. Par défaut, Windows affiche toutes les commandes que les utilisateurs saisissent ou exécutent.

Pour empêcher l'affichage des valeurs des champs sécurisés dans la sortie du script pour les appareils Unix (macOS ou Linux), le script ne doit pas contenir set -x avant l'exécution. Cette omission empêche l'affichage des commandes exécutées qui contiennent des valeurs sécurisées.

Obtenir : 

# obtenir le champ sécurisé
> ninjarmm-cli get globalsecure
sampletext1

Définir :

# définir le champ sécurisé
> ninjarmm-cli set globalsecure sampletext2

Texte

Obtenir :

# obtenir le champ texte
> ninjarmm-cli get globaltext
sampletext1

Définir :

# définir le champ texte
> ninjarmm-cli set globaltext sampletext2

Heure

Pour le champ Heure, la valeur définie doit être exprimée en secondes ou au format ISO (hh:mm:ss).

Obtenir :

# obtenir la valeur du champ heure
> ninjarmm-cli get globaldatetime
120

Définir :

# définir la valeur du champ « Time »
> ninjarmm-cli set globaldatetime 3600
3600

> ninjarmm-cli set testdatetime 00:00:00
0

URL

Le champ URL est limité à 200 caractères et doit commencer par https://.

Obtenir :

# obtenir le champ URL
> ninjarmm-cli get url
https://www.google.com

Définir :

# définir le champ URL
> ninjarmm-cli set url https://www.ninjarmm.com

Champs de documentation

Obtenir :

# obtenir la liste des modèles
> ninjarmm-cli templates
1=modèle 1
2=modèle 2

# obtenir la liste des documents par ID de modèle
> ninjarmm-cli documents 2
16=modèle 2

# obtenir la liste des documents par nom de modèle
> ninjarmm-cli documents « modèle 2 »
16=modèle 2

# obtenir la valeur du champ à partir du document
> ninjarmm-cli get « modèle 2 » « modèle 2 » nom du champ
Il s'agit de la valeur du champ

Définir :

# définir l'attribut pour le document/attribut spécifié par nom de document et ID/nom de modèle (guillemets obligatoires)
> ninjarmm-cli org-set « modèle 2 » « ExampleDoc » ExampleTextField « SampleText1 »

# définir l'attribut pour un seul document/attribut par nom de modèle (guillemets obligatoires)
> ninjarmm-cli org-set « modèle 2 » ExampleTextField « SampleText1 »

# effacer la valeur du document par nom de document et identifiant/nom du modèle (guillemets obligatoires, représenté par NULL)
> ninjarmm-cli org-clear « template 2 » « ExampleDoc » ExampleTextField

# effacer la valeur d'un document unique par nom de modèle (guillemets obligatoires, représenté par NULL)
> ninjarmm-cli org-clear « template 2 » ExampleTextField

Options :

# obtenir la liste des valeurs valides pour le nom d'attribut de document par nom de document et identifiant/nom de modèle (réel pour les attributs déroulants et à sélection multiple)
> ninjarmm-cli org-options « template 2 » « ExampleDoc » ExampleTextField

# obtenir la liste des valeurs valides pour un nom d'attribut de document unique par nom de modèle (réel pour les attributs déroulants et à sélection multiple)
> ninjarmm-cli org-options « template 2 » ExampleTextField

Interagir avec les champs personnalisés via des commandes PowerShell ou des scripts personnalisés

Les exemples de cette section montrent comment utiliser les commandes PowerShell ou les scripts pour des types spécifiques de champs personnalisés. Utilisez les liens ci-dessous pour accéder aux scripts que vous souhaitez consulter :

Case à cocher

Pour le champ Case à cocher, la valeur définie doit être soit vrai (1), soit faux (0).

Obtenir :

# obtenir la valeur du champ case à cocher
> Ninja-Property-Get globalcheckbox
0

Définir :

# définir une valeur booléenne pour le champ case à cocher
> Ninja-Property-Set globalcheckbox 0
0
> Ninja-Property-Set globalcheckbox 1
1
> Ninja-Property-Set globalcheckbox true
1
> Ninja-Property-Set globalcheckbox false
0

Date

Pour le champ Date, la valeur définie doit être exprimée en secondes ou au format ISO (aaaa-mm-jj en UTC).

Obtenir :

# obtenir la valeur du champ date
> Ninja-Property-Get globaldate
456

Définir :

# définir la valeur du champ Date
> Ninja-Property-Set globaldate 1626875470000

> Ninja-Property-Set testdate 2021-10-15
1634256000

Date/Heure

Obtenir :

# obtenir la valeur du champ date-heure
> Ninja-Property-Get globaldatetime
1626875470000

Définir :

# définir la valeur du champ date-heure
> Ninja-Property-Set globaldatetime 1626875470000
1626875470000

> Ninja-Property-Set testdatetime 2021-10-15T00:00:00
1634256000

Décimal

Obtenir :

# obtenir la valeur du champ décimal
> Ninja-Property-Get globaldecimal
123,456

Définir :

# définir la valeur du champ décimal
> Ninja-Property-Set typedecimal 1
1

> Ninja-Property-Set typedecimal 1.23
1.23

> Ninja-Property-Set typedecimal 1.23
1.23

> Ninja-Property-Set typedecimal 1.2345678901234567890
1,234567 # tronqué à la précision maximale, il est préférable de ne pas utiliser une précision supérieure afin d'éviter les problèmes de conversion de type de données

> Ninja-Property-Set typedecimal 1234567890,1234567890
1234567890,123457

Liste déroulante

Options :

# liste des options pour le champ déroulant
> Ninja-Property-Options globaldropdown
333f541e-747e-4a1e-a2e2-a82c1c2f2008=Option2
74a6ffda-708e-435a-86e3-40b67c4f981a=Option1
f1ba449c-fd34-49df-b878-af3877180d17=Option3

Obtenir le GUID de l'option par son nom :

# trouver le GUID de l'option par le nom de l'option pour le champ déroulant
> Ninja-Property-Get globaldropdown | grep « Option1 » | awk -F= '{print $1}'
74a6ffda-708e-435a-86e3-40b67c4f981a

Obtenir :

# obtenir la valeur du champ déroulant
> Ninja-Property-Get globaldropdown
74a6ffda-708e-435a-86e3-40b67c4f981a

Définir :

# définir la valeur du champ déroulant
> Ninja-Property-Set globaldropdown f1ba449c-fd34-49df-b878-af3877180d17

E-mail

Obtenir :

# obtenir la valeur enregistrée
> Ninja-Property-Get typeemail
[email protected]

Définir :

# valeurs correctes
> Ninja-Property-Set typeemail [email protected]
[email protected]

> Ninja-Property-Set typeemail [email protected]
[email protected]

# définir des valeurs incorrectes
> Ninja-Property-Set typeemail [email protected]
Erreur : format/type de valeur incorrect...

Entier

Pour le champ Integer, la valeur définie doit être un entier (un nombre entier sans décimales) compris entre -2147483648 et 2147483647.

Obtenir :

# obtenir la valeur du champ entier
> Ninja-Property-Get globalinteger
456

Définir :

# définir la valeur du champ entier
> Ninja-Property-Set globalinteger 123

Adresse IP

Pour le champ IP , la valeur définie doit être au format IPv4 (Internet Protocol version 4) ou IPv6 (Internet Protocol version 6).

Obtenir :

# obtenir la valeur stockée
> Ninja-Property-Get typeipaddress
192.168.1.100

Définir :

# définir les valeurs correctes
> Ninja-Property-Set typeipaddress 255.255.255.255
255.255.255.255

> Ninja-Property-Set typeipaddress 0.0.0.0
0.0.0.0

# définir des valeurs incorrectes
> Ninja-Property-Set typeipaddress 192.168.1.
Erreur : format/type de valeur incorrect...

> Ninja-Property-Set typeipaddress 255.255.255.256
Erreur : format/type de valeur incorrect...

> Ninja-Property-Set typeipaddress 0.-1.0.0
Erreur : format/type de valeur incorrect...

Plusieurs lignes

En raison des restrictions de l'interface CLI ou du terminal, le texte doit être saisi dans l'invite de commande sur une seule ligne et est limité à 10 000 caractères.

Obtenir :

# obtenir le champ de texte
> Ninja-Property-Get globaltext
sampletext1

Définir :

# définir le champ de texte
>Ninja-Property-Set globaltext sampletext2

Sélection multiple

Options :

# lister les options pour le champ à sélection multiple
> Ninja-Property-Options globalmultiselect
333f541e-747e-4a1e-a2e2-a82c1c2f2008=Option2
74a6ffda-708e-435a-86e3-40b67c4f981a=Option1
f1ba449c-fd34-49df-b878-af3877180d17=Option3

Obtenir le GUID de l'option par son nom :

# trouver le GUID de l'option par son nom pour le champ à sélection multiple
> Ninja-Property-Options globalmultiselect | grep « Option 1 » | awk -F= '{print $1}'
74a6ffda-708e-435a-86e3-40ba67c4f981a

Définir :

# définir plusieurs valeurs pour le champ à sélection multiple, séparées par des virgules
> Ninja-Property-Set globalmultiselect 333f541e-747e-4a1e-a2e2-a82c1c2f2008, 
74a6ffda-708e-435a-86e3-40b67c4f981a

Obtenir :

# obtenir les valeurs pour le champ à sélection multiple
> Ninja-Property-Get globalmultiselect
333f541e-747e-4a1e-a1e2-a82c1c2f2008, 74a6ffda-708e-435a-86e3-40b67c4f981a

Numéro de téléphone

Obtenir :

# obtenir la valeur enregistrée
Ninja-Property-Get typephone
+1234567890

Définir :

# définir les valeurs correctes
> Ninja-Property-Set typephone +77013273916
+77013273916

> Ninja-Property-Set typephone 123456789012344567
123456789012344567

> Ninja-Property-Set typephone 123456789012344567
123456789012344567

> Ninja-Property-Set typephone +123456789012344567
+123456789012344567

# définir des valeurs incorrectes
> Ninja-Property-Set typephone 14953273916qwerty
Erreur : format/type de valeur incorrect...

> Ninja-Property-Set typephone 14953273916qwerty
Erreur : format/type de valeur incorrect...

> Ninja-Property-Set typephone 1234567890123445678 # trop long
Erreur : format/type de valeur incorrect...

> Ninja-Property-Set typephone ++123456789012344567
Erreur : format/type de valeur incorrect...

Sécurisé

Obtenir :

# obtenir le champ sécurisé
> Ninja-Property-Get globalsecure
sampletext1

Définir :

# définir le champ sécurisé
>Ninja-Property-Set globalsecure sampletext2

Texte

Obtenir :

# obtenir le champ texte
> Ninja-Property-Get globaltext
sampletext1

Définir :

# définir le champ texte
>Ninja-Property-Set globaltext sampletext2

Heure

Pour le champ Heure , la valeur définie doit être exprimée en secondes ou au format ISO (hh:mm:ss).

Obtenir :

# obtenir la valeur du champ heure
> Ninja-Property-Get globaldatetime
120

Définir :

# définir la valeur du champ « time »
> Ninja-Property-Set globaldatetime 3600
3600

> Ninja-Property-Set testdatetime 00:00:00
0

URL

Le champ URL est limité à 200 caractères et doit commencer par « https:// ».

Obtenir :

# obtenir le champ URL
> Ninja-Property-Get url
https://www.google.com

Définir :

# définir le champ URL
>Ninja-Property-Set url https://www.google.com

Champs de documentation

Obtenir :

# obtenir la liste des modèles
> Ninja-Property-Docs-Templates
1=modèle 1
2=modèle 2

# obtenir la liste des documents par ID de modèle
> Ninja-Property-Docs-Names 2
16=modèle 2

# obtenir la liste des documents par nom de modèle
> Ninja-Property-Docs-Names « modèle 2 »
16=modèle 2

# obtenir la valeur du champ à partir du document
> Ninja-Property-Docs-Get « modèle 2 » « modèle 2 » nom du champ
Il s'agit de la valeur du champ

Définir :

# définir l'attribut pour le document/attribut spécifié par nom de document et ID/nom de modèle (guillemets obligatoires)
> Ninja-Property-Docs-Set 2 « ExampleDoc » ExampleTextField

# définir l'attribut pour un seul document/attribut par nom de modèle (guillemets obligatoires)
> Ninja-Property-Docs-Set-Single « modèle 2 » ExampleTextField « sampletext1 »

# effacer la valeur du document par nom de document et identifiant/nom du modèle (guillemets obligatoires, représenté par NULL)
> Ninja-Property-Docs-Clear « template 2 » « ExampleDoc » ExampleTextField

# effacer la valeur d'un document unique par nom de modèle (guillemets obligatoires, représenté par NULL)
> Ninja-Property-Docs-Clear-Single « template 2 » ExampleTextField

Options :

# obtenir la liste des valeurs valides pour le nom d'attribut de document par nom de document et identifiant/nom de modèle (valable pour les attributs déroulants et à sélection multiple)
> Ninja-Property-Docs-Options « modèle 2 » « ExampleDoc » ExampleTextField

# obtenir la liste des valeurs valides pour un nom d'attribut de document unique par nom de modèle (réel pour les attributs déroulants et à sélection multiple)
> Ninja-Property-Docs-Options-Single « template 2 » ExampleTextField

Ressources supplémentaires

Pour en savoir plus sur la documentation, les champs personnalisés, l'interface CLI et les scripts, consultez les articles suivants :

Interface de ligne de commande (CLI)

Utilisation de l'interface de ligne de commande (CLI) dans NinjaOne.

Documentation et champs personnalisés

Script

FAQ

Pour aller plus loin