Sujet
Cet article explique comment créer un appareil non géré dans NinjaOne à l'aide des outils d'interface de ligne de commande (CLI).
Environnement
NinjaOne Endpoint Management
Description
Lorsque vous créez des appareils non gérés via l'interface CLI, vous pouvez détecter des éléments tels que des moniteurs, des imprimantes USB et d'autres périphériques, et définir la relation entre ces éléments et les appareils gérés dans NinjaOne. De plus, vous pouvez attribuer l'appareil non géré à un utilisateur via l'interface CLI, et NinjaOne remplira les données dans la console le cas échéant.
Lorsque vous installez l'agent RMM NinjaOne sur le périphérique, 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 afin de faciliter ce processus.
| Nom de la ligne de commande | Description |
|---|---|
| unmanaged-new | Créez un appareil non géré et transmettez un objet JSON pour le définir. Lorsque vous créez un appareil non géré via l'interface CLI, celui-ci est automatiquement attribué à la même organisation et au même emplacement que l'appareil géré associé. |
| unmanaged-get | Obtenir les valeurs des appareils non gérés liés à l'appareil géré, y compris les numéros d'identification de chaque actif (à l'exception des champs sécurisés). L'appareil non géré doit appartenir à la même organisation et au même emplacement que l'appareil 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éfinissez l'utilisateur actuellement attribué au périphérique. 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 périphériques appartenant à la même organisation que l'utilisateur. Les techniciens doivent avoir l'autorisation d'accéder au périphérique. |
Le tableau suivant répertorie les champs que vous pouvez utiliser avec la ligne de commande unmanaged-new pour définir les 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 d'actif directionnelle entre le dispositif créateur et le dispositif 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 à un utilisateur de l'appareil | Non | Booléen | Cette option est « false » par défaut. |
| ID de l'actif | Non | Chaîne | |
| Statut de l'actif | Non | Chaîne | |
| Date d'achat | Non | Chaîne | Accepte les dates au format AAAA-MM-JJ. |
| Montant de l'achat | Non | Flottant | |
| 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 | Multiple | Comme défini lors de la création. |
Par exemple :
.ninjarmm-clie.exe unmanaged-new '{ "assignToDeviceUser":true, "assetId": "asset-001",
"assetSerialNumber": "asset-serial-001", "assetStatus": "in use", "customFieldValues":
{"exampleCustomFieldName": "Custom Field Value", "typeipaddress": "255.255.255.255"},
« endOfLifeDate » : « 2025-12-31 », « expectedLifetime » : « 5 years », « name » : « Test Device with
CF », « purchaseAmount » : 1000, « purchaseDate » : « 2020-01-01 », « relation » : « related to »,
« role » : « Another Role », « warrantyEndDate » : « 2023-12-31 », « warrantyStartDate » : « 2021-01-01 »}'Utilisation des commandes PowerShell
NinjaOne prend en charge les commandes PowerShell pour les opérations suivantes :
- New-NinjaUnmanagedDevice
- Get-NinjaUnmanagedDevice
- Set-NinjaUnmanagedDevice
- Set-NinjaUser
Par exemple :
$DiscoveredMonitor = @{
role = « Monitor »
name = « AEG-12345 on Lukes Desktop »
relation = « Connected To »
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 afficher tous les articles connexes.