Sujet
Cet article explique comment créer un appareil non géré dans NinjaOne à l'aide des outils de l'interface de ligne de commande (CLI).
Environnement
NinjaOne IT Asset Management (ITAM)
Description
Lors de la création de périphériques non gérés via la CLI, vous pouvez détecter des éléments tels que des écrans, des imprimantes USB et d'autres périphériques, et définir la relation que ces éléments entretiennent avec les périphériques gérés dans NinjaOne. De plus, vous pouvez attribuer le périphérique non géré à un utilisateur via la CLI, et NinjaOne renseignera les données dans la console le cas échéant.
Lorsque vous installez l'agent RMM NinjaOne sur l'appareil, NinjaOne envoie les numéros de série du système et du BIOS à la charge utile initiale afin d'optimiser le mappage des données.
Index
Sélectionnez une catégorie pour en savoir plus :
- Nouvelles options de ligne de commande
- Utilisation des commandes PowerShell
- Ressources supplémentaires
Nouvelles options de ligne de commande
Nous avons créé de nouvelles lignes de commande et ajouté des options aux lignes de commande existantes pour faciliter ce processus.
| Nom de la ligne de commande | Description |
|---|---|
| unmanaged-new | Crée un périphérique non géré et transmet un objet JSON pour le définir. Lorsque vous créez un périphérique non géré via l'interface CLI, celui-ci est automatiquement affecté à la même organisation et au même emplacement que son périphérique géré associé. |
| unmanaged-get | Récupère les valeurs des périphériques non gérés associés au périphérique géré, y compris les numéros d'identification de chaque ressource (à l'exclusion des champs sécurisés). Le périphérique non géré doit appartenir à la même organisation et au même emplacement que son périphérique géré associé. |
| unmanaged-set | Mettre à jour les valeurs des appareils non gérés existants à l'aide de l'ID de l'appareil. Cette ligne de commande ne fonctionne que si l'appareil non géré est associé à un appareil géré existant et appartient à la même organisation et au même emplacement. |
| user-set | Définit l'utilisateur actuellement affecté à l'appareil. Vous pouvez utiliser une adresse e-mail comme paramètre, et NinjaOne recherchera les utilisateurs finaux, les techniciens et les contacts. Si un compte ou un contact est limité à une organisation, NinjaOne ne fera correspondre que les appareils appartenant à la même organisation que l'utilisateur. Les techniciens doivent disposer d'une autorisation d'accès à l'appareil. |
Le tableau suivant répertorie les champs que vous pouvez utiliser avec la ligne de commande unmanaged-new pour définir des appareils non gérés.
| Nom du champ | Obligatoire (Oui/Non) | Type | Remarques |
|---|---|---|---|
| Rôle | Oui | Chaîne | |
| Nom | Oui | Chaîne | |
| Relation | Oui | Chaîne | Nom de la relation directionnelle entre l'appareil créateur et l'appareil créé. |
| Date de début de la garantie | Non | Chaîne | Accepte les dates au format AAAA-MM-JJ. |
| Date de fin de garantie | Non | Chaîne | Accepte les dates au format AAAA-MM-JJ. |
| Attribuer à l'utilisateur de l'appareil | Non | Booléen | Cette option est définie sur « false » par défaut. |
| ID de l'actif | Non | Chaîne | |
| État de l'élément | Non | Chaîne | |
| Date d'achat | Non | Chaîne | Accepte les dates au format AAAA-MM-JJ. |
| Montant de l'achat | Non | Nombre à virgule flottante | |
| Durée de vie prévue | Non | Chaîne | Accepte 1, 2, 3, 4 ou 5 ans. |
| Date de fin de vie | Non | Chaîne | Accepte les dates au format AAAA-MM-JJ. |
| Numéro de série de l'actif | Non | Chaîne | |
| Valeurs des champs personnalisés | Non | Plusieurs | Comme défini lors de la création. |
Par exemple :
.ninjarmm-cli.exe unmanaged-new '{ "assignToDeviceUser":true, "assetId": "asset-001",
"assetSerialNumber": "asset-serial-001", "assetStatus": "in use", "customFieldValues":
{"exampleCustomFieldName": "Valeur du champ personnalisé", "typeipaddress": "255.255.255.255"},
"endOfLifeDate": "2025-12-31", "expectedLifetime": "5 ans", "name": "Appareil de test avec
CF", "purchaseAmount": 1000, "purchaseDate": "2020-01-01", "relation": "lié à",
"role": "Autre rôle", "warrantyEndDate": "31/12/2023", "warrantyStartDate": "01/01/2021"}'Utilisation des commandes PowerShell
NinjaOne prend en charge les commandes PowerShell suivantes :
- New-NinjaUnmanagedDevice
- Get-NinjaUnmanagedDevice
- Set-NinjaUnmanagedDevice
- Set-NinjaUser
Par exemple :
$DiscoveredMonitor = @{
role = "Monitor"
name = "AEG-12345 sur le bureau de Luke"
relation = "Connecté à"
assignToDeviceUser = $true
assetId = "123456"
assetSerialNumber = "123456"
customFieldHashMap = @{
monitorResolution = "1920 x 1080"
monitorManufacturer = "AEG"
monitorModel = "12345"
}
}
$Null = New-NinjaUnmanagedDevice $DiscoveredMonitor
$Devices = Get-NinjaUnmanagedDevice -Role 'Monitor' -Relation 'Connected To'
$UpdateDevice = $Devices[0]
$UpdateDevice.monitorResolution = '5120 x 1440'
$Null = Set-NinjaUnmanagedDevice $UpdateDeviceRessources supplémentaires
Consultez NinjaOne IT Asset Management : Catalogue de ressources pour consulter tous les articles ITAM.