Rubrique
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, puis 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.
Indexer
Sélectionnez une catégorie pour en savoir plus :
- Nouvelles options de ligne de commande
- Utilisation des commandes PowerShell
- Ressources complé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 |
|---|---|
| Non géré-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 de ligne de commande, celui-ci est automatiquement assigné à la même organisation et au même emplacement que son périphérique géré associé. |
| Non géré-get | Récupère les valeurs des appareils non gérés associé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éfinit l’Utilisateur assigné à l’appareil. Vous pouvez utiliser une adresse e-mail comme paramètre ; NinjaOne effectuera alors une recherche parmi 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 | Notes |
|---|---|---|---|
| Rôle | Oui | Chaîne | |
| Nom | Oui | Chaîne | |
| Relation | Oui | Chaîne | Nom de la relation d'actif directionnelle entre le périphérique créateur et le périphérique 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. |
| Assigner à 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 | |
| Statut 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 années. |
| 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": "en cours d’utilisation", "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" : "2023-12-31", "warrantyStartDate" : "2021-01-01"}'Utilisation des commandes PowerShell
NinjaOne prend en charge les commandes PowerShell suivantes pour le système d'exploitation :
- Nouveau NinjaUnmanagedDevice
- Get-NinjaUnmanagedDevice
- Définir-NinjaUnmanagedDevice
- Définir-NinjaUser
Par exemple :
$DiscoveredMonitor = @{
role = "Surveiller"
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 complémentaires
Consultez la section « NinjaOne IT Asset Management : Catalogue de ressources » pour consulter tous les articles consacrés à la gestion des actifs informatiques (ITAM).