{"id":381197,"date":"2024-11-11T05:53:57","date_gmt":"2024-11-11T05:53:57","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=pseudo_docs&p=381197"},"modified":"2024-12-18T05:59:27","modified_gmt":"2024-12-18T05:59:27","slug":"champs-personnalises-avances","status":"publish","type":"pseudo_docs","link":"https:\/\/www.ninjaone.com\/fr\/docs\/enrolement-des-appareils-et-outils-de-gestion\/champs-personnalises\/champs-personnalises-avances\/","title":{"rendered":"Champs personnalis\u00e9s avanc\u00e9s"},"content":{"rendered":"

Dans ce document, nous verrons comment interagir depuis le syst\u00e8me d’exploitation \u00e0 l’aide des\u00a0champs personnalis\u00e9s<\/strong>\u00a0avanc\u00e9s.<\/strong> Il s’agit d’un outil puissant permettant aux administrateurs informatiques de surveiller et de contr\u00f4ler presque tout avec NinjaOne.<\/p>\n

Outils propos\u00e9s par NinjaOne \u00e0 cette fin, et quelques exemples.<\/p>\n

\n
\n

Comment interagir entre le syst\u00e8me d’exploitation et les champs personnalis\u00e9s de NinjaOne\u00a0?<\/h2>\n<\/div>\n<\/div>\n
\n
\n

Il existe deux m\u00e9thodes, NinjaRMM-Cli et PowerShell.<\/p>\n

1.\u00a0NinjaRMM-Cli<\/strong>\u00a0est un outil en ligne de commande qui peut \u00eatre utilis\u00e9 du c\u00f4t\u00e9 du syst\u00e8me d’exploitation avec le langage de script natif du syst\u00e8me d’exploitation (Batch, Bash, ShellScript, Powershell). Cet outil dispose de commandes sp\u00e9cifiques pour interagir avec les champs personnalis\u00e9s.<\/p>\n

L’outil NinjaRMM-Cli est install\u00e9 sur un terminal lorsque l’agent NinjaOne est install\u00e9 sur un terminal Windows, Mac ou Linux.<\/p>\n

Selon le syst\u00e8me d’exploitation, le chemin d’acc\u00e8s \u00e0 ce fichier ex\u00e9cutable peut se trouver dans les dossiers suivants.<\/p>\n

    \n
  • Windows\u00a0: C:\\ProgramData\\NinjaRMMAgent\\ninjarmm-cli.exe.<\/li>\n
  • Mac: \/Applications\/NinjaRMMAgent\/programdata\/ninjarmm-cli.<\/li>\n
  • Linux: \/opt\/NinjaRMMAgent\/programdata\/ninjarmm-cli.<\/li>\n<\/ul>\n

    NinjaRMM-Cli<\/em>\u00a0get est la commande utilis\u00e9e pour obtenir ou lire la valeur d’un champ personnalis\u00e9.<\/p>\n

    NinjaRMM-Cli<\/em>\u00a0set est la commande utilis\u00e9e pour attribuer une valeur \u00e0 un champ personnalis\u00e9.<\/p>\n

    La syntaxe est la suivante\u00a0: ninjarmm-cli set value (\u00ab\u00a0set\u00a0\u00bb doit \u00eatre en minuscules)<\/p>\n

    2.\u00a0PowerShell<\/strong>, cet outil autrefois r\u00e9serv\u00e9 \u00e0 Windows, est d\u00e9sormais \u00e9galement disponible pour Mac et Linux.<\/p>\n

    Les commandes Ninja-Property-Get et Ninja-Property-Set sont les cl\u00e9s de l’interaction entre le syst\u00e8me d’exploitation et NinjaOne \u00e0 l’aide de PowerShell.<\/p>\n

    Ninja-Property-Get<\/em>\u00a0est la commande PowerShell de NinjaOne qui permet d’obtenir ou de lire la valeur d’un champ personnalis\u00e9. La syntaxe est la suivante\u00a0: Ninja-Property-Get fieldName.<\/p>\n

    Ninja-Property-Set<\/em>\u00a0est la commande PowerShell de NinjaOne qui permet de d\u00e9finir un champ personnalis\u00e9 \u00e0 une valeur sp\u00e9cifique. La syntaxe est la suivante\u00a0: Ninja-Property-Set fieldName Value.<\/p>\n

    Vous trouverez \u00e0 la fin de ce document le lien vers une documentation plus compl\u00e8te sur l’utilisation de NinjaRMM-Cli et l’interaction de PowerShell avec NinjaOne.<\/p>\n<\/div>\n<\/div>\n

    \n
    \n

    Strat\u00e9gies pour les champs personnalis\u00e9s avanc\u00e9s<\/h2>\n<\/div>\n<\/div>\n
    \n
    \n

    Nous allons montrer deux exemples d’utilisation de champs personnalis\u00e9s, tous deux ayant le m\u00eame objectif\u00a0: d\u00e9terminer si un appareil est rattach\u00e9 \u00e0 un domaine ou non. Un exemple utilise NinjaRMM-Cli, l’autre, PowerShell. Nous allons cr\u00e9er un champ personnalis\u00e9 de r\u00f4le de type case \u00e0 cocher appel\u00e9 domainjoined (domaine rejoint), qui servira pour les deux exemples. La diff\u00e9rence sera dans les automatisations.<\/p>\n

    \u00a01. Cr\u00e9er un champ personnalis\u00e9 de r\u00f4le nomm\u00e9 domainjoined et le mapper aux ordinateurs portables Windows, aux ordinateurs de bureau Windows et aux serveurs Windows.<\/strong><\/p>\n

    a) Allez dans Administration, puis Appareils, puis Champs personnalis\u00e9s de r\u00f4le.<\/p>\n

    b) Cliquez sur Ajouter, puis choisissez Champ. Une bo\u00eete de dialogue appara\u00eet.<\/p>\n

    c) Remplissez l’\u00e9tiquette et le nom. L’\u00e9tiquette est Domain Joined (domaine rejoint); le nom est domainjoined.<\/p>\n

    d) S\u00e9lectionnez \u00ab\u00a0case \u00e0 cocher\u00a0\u00bb comme type de champ.<\/p>\n

    e) Cliquez sur Cr\u00e9er.<\/p>\n

    f) Attribuez les autorisations pour les techniciens en lecture seule, les autorisations pour les automatisations en lecture\/\u00e9criture et les autorisations pour l’API en lecture\/\u00e9criture.<\/p>\n

    g) Compl\u00e9tez la description, le texte de l’infobulle et le texte du pied de page si vous le souhaitez. Vous pouvez \u00e9galement choisir si ce champ personnalis\u00e9 est obligatoire.<\/p>\n

    h) Cliquez sur enregistrer. La capture d’\u00e9cran ci-dessous montre la bo\u00eete de dialogue Cr\u00e9er un champ personnalis\u00e9 de r\u00f4le.<\/p>\n

    i) Allez dans Administration, puis Appareils, puis R\u00f4les.<\/p>\n

    j) Passez la souris sur le r\u00f4le de l’appareil Windows Server pour faire appara\u00eetre le bouton \u00ab\u00a0Modifier\u00a0\u00bb\u00a0: cliquez dessus. Une bo\u00eete de dialogue appara\u00eet.<\/p>\n

    k) Cliquez sur Ajouter. S\u00e9lectionnez le champ.<\/p>\n

    l) Dans le menu d\u00e9roulant, s\u00e9lectionnez le champ personnalis\u00e9 Domain Joined.<\/p>\n

    m) Cliquez sur Enregistrer.<\/p>\n

    n) R\u00e9p\u00e9tez l’op\u00e9ration pour les r\u00f4les ordinateurs Windows ordinateurs portables Windows.<\/p>\n

    2. Cr\u00e9er une automatisation PowerShell nomm\u00e9e ChkIfDomainJoinedPS.<\/strong><\/p>\n

    a) Allez dans Administration, puis Biblioth\u00e8que, puis Automatisation.<\/p>\n

    b) Cliquez sur Ajouter, puis choisissez Nouveau script. La bo\u00eete de dialogue de cr\u00e9ation de script appara\u00eet.<\/p>\n

    c) Remplissez le champ \u00ab\u00a0nom\u00a0\u00bb comme suit\u00a0: ChkIfDomainJoinedPS.<\/p>\n

    d) Si vous le souhaitez, vous pouvez compl\u00e9ter la description.<\/p>\n

    e) Dans la rubrique Cat\u00e9gories, s\u00e9lectionnez celle de votre choix.<\/p>\n

    f) Dans Langage, s\u00e9lectionnez PowerShell.<\/p>\n

    g) Dans Syst\u00e8me d’exploitation, s\u00e9lectionnez Windows.<\/p>\n

    h) Dans Architecture, s\u00e9lectionnez Tous.<\/p>\n

    i) Laissez les champs Variables de script et Param\u00e8tres vides.<\/p>\n

    j) Sur le c\u00f4t\u00e9 gauche, collez le code suivant\u00a0:<\/p>\n

    if ((gwmi win32_computersystem).partofdomain -eq $true) {<\/p>\n

    Ninja-Property-Set fieldName 1<\/p>\n

    } else {<\/p>\n

    Ninja-Property-Set fieldName 0<\/p>\n

    }<\/p>\n

    k) Cliquez sur Enregistrer. Saisissez la r\u00e9ponse \u00e0 votre m\u00e9thode MFA, puis fermez.<\/p>\n

    3. Cr\u00e9er une automatisation Batch nomm\u00e9e ChkIfDomainJoinedBatch.<\/strong><\/p>\n

    a) Allez dans Administration, puis Biblioth\u00e8que, puis Automatisation.<\/p>\n

    b) Cliquez sur Ajouter, puis choisissez Nouveau script. La bo\u00eete de dialogue de cr\u00e9ation de script appara\u00eet.<\/p>\n

    c) Remplissez le champ \u00ab\u00a0nom\u00a0\u00bb comme suit\u00a0: ChkIfDomainJoinedBatch.<\/p>\n

    d) Si vous le souhaitez, vous pouvez compl\u00e9ter la description.<\/p>\n

    e) Dans la rubrique Cat\u00e9gories, s\u00e9lectionnez celle de votre choix.<\/p>\n

    f) Dans Langage, s\u00e9lectionnez Batch.<\/p>\n

    g) Dans Syst\u00e8me d’exploitation, s\u00e9lectionnez Windows.<\/p>\n

    h) Dans Architecture, s\u00e9lectionnez Tous.<\/p>\n

    i) Laissez les champs Variables de script et Param\u00e8tres vides.<\/p>\n

    j) Sur le c\u00f4t\u00e9 gauche, collez le code suivant\u00a0:<\/p>\n

    @echo off<\/p>\n

    for \/F \u00ab\u00a0tokens=1*\u00a0\u00bb %%G in (‘SYSTEMINFO ^| FIND \/I \u00ab\u00a0Domain :\u00a0\u00bb‘) do set \u00ab\u00a0sDomain=%~H\u00a0\u00bb<\/p>\n

    IF \u00ab\u00a0%sDomain%\u00a0\u00bb==\u00a0\u00bbWORKGROUP\u00a0\u00bb (<\/p>\n

    C:\\ProgramData\\NinjaRMMAgent\\NinjaRMM-Cli set domainjoined 0<\/p>\n

    ) ELSE (<\/p>\n

    C:\\ProgramData\\NinjaRMMAgent\\NinjaRMM-Cli set domainjoined 1<\/p>\n

    )<\/p>\n

    k) Cliquez sur Enregistrer. Saisissez la r\u00e9ponse \u00e0 votre m\u00e9thode MFA, puis fermez.<\/p>\n

    Maintenant, allez dans le tableau de bord des appareils et choisissez n’importe quel ordinateur de bureau ou portable Windows ou serveur Windows. V\u00e9rifiez le statut du champ personnalis\u00e9 Domain Joined, qui doit indiquer No value. Ex\u00e9cutez le script ChkIfDomainJoinedPS.<\/p>\n

    Ensuite, choisissez un autre ordinateur de bureau Windows, un ordinateur portable Windows ou un serveur Windows et r\u00e9p\u00e9tez la proc\u00e9dure pr\u00e9c\u00e9dente, mais cette fois, ex\u00e9cutez le script ChkIfDomainJoinedBatch.<\/p>\n

    Apr\u00e8s quelques secondes, vous pouvez v\u00e9rifier le champ personnalis\u00e9 \u00ab\u00a0Domaine joined\u00a0\u00bb sur les deux appareils, et l’\u00e9tat du champ personnalis\u00e9 sera mis \u00e0 jour en cons\u00e9quence.<\/p>\n

    Vous pouvez aller plus loin en cr\u00e9ant une t\u00e2che programm\u00e9e et en l’ex\u00e9cutant r\u00e9guli\u00e8rement sur tous vos appareils Windows pour maintenir le statut \u00e0 jour.<\/p>\n<\/div>\n<\/div>\n","protected":false},"author":158,"featured_media":0,"parent":394929,"menu_order":0,"template":"","meta":{"_acf_changed":false,"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","_lmt_disableupdate":"no","_lmt_disable":""},"class_list":["post-381197","pseudo_docs","type-pseudo_docs","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/pseudo_docs\/381197","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/pseudo_docs"}],"about":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/types\/pseudo_docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/users\/158"}],"up":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/pseudo_docs\/394929"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/media?parent=381197"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}