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

PowerShell : Get-NinjaUnmanagedDevice

  • Dernière mise à jour 2 septembre 2026

Rubrique

Cet article explique comment utiliser Get-NinjaUnmanagedDevice pour récupérer les appareils non gérés associés à l'appareil actuel.

Si vous utilisez le module PowerShell NinjaOne en dehors d’un script d’automatisation, vous devrez peut-être ajuster la stratégie d’exécution de PowerShell. Pour plus d’informations sur les stratégies d’exécution, consultez la documentation de Microsoft : À propos des stratégies d’exécution ( lien externe).

Environnement

  • NinjaOne
  • Microsoft PowerShell

Description

La cmdlet Get-NinjaUnmanagedDevice récupère une liste des appareils non gérés associés à l'appareil actuel
. Vous pouvez affiner les résultats en spécifiant des filtres tels que le nom, le rôle, la relation ou l'ID. La cmdlet renvoie des informations détaillées sur chaque appareil non géré, à l'exception des champs sécurisés.

Les appareils non gérés doivent appartenir à la même organisation et se trouver au même emplacement que
leur appareil géré associé.

Syntaxe

Get-NinjaUnmanagedDevice [[-Nom]] [-Rôle] [-Relation] []

Exemples

Exemple 1 : récupérer tous les appareils non gérés

PS C:> Get-NinjaUnmanagedDevice
assetId : 23458
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
ID : 1308
name : Nvidia 5070
Get-NinjaUnmanagedDevice
1 / 5
Si aucun nom, rôle ou relation n’est spécifié, cette commande renvoie tous les périphériques non gérés ayant une relation d’actif
avec le périphérique actuel.
Exemple 2 : filtrer la liste à l’aide des paramètres facultatifs
purchaseAmount : 0
purchaseDate :
relation : Part of
role : GPU
warrantyEndDate :
warrantyStartDate :
assetId : 23457
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
id : 1307
name : LG Ultrawide
purchaseAmount : 0
purchaseDate :
relation : Connecté à
role : Moniteurs
warrantyEndDate :
warrantyStartDate :

Si aucun nom, rôle ou relation n'est fourni, la commande renvoie tous les appareils non gérés ayant une relation d'actif
avec l'appareil actuel.

Exemple 2 : filtrer la liste à l'aide des paramètres facultatifs

PS C:> Get-NinjaUnmanagedDevice -Relation "Part of"
assetId : 23458
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
ID : 1308
name : Nvidia 5070
purchaseAmount : 0
purchaseDate :
relation : Part of
role : GPU
warrantyEndDate :
warrantyStartDate :

Filtrez les appareils renvoyés en spécifiant le nom, le rôle, la relation ou l’ID que vous recherchez.

Paramètres

-Id
Spécifiez l’ID unique d’un appareil non géré. Notez qu’il ne s’agit pas de l’ID d’actif
et qu’il n’est pas visible dans l’interface utilisateur Web.
Type : Int32[]
Ensembles de paramètres : ID
Alias :
Obligatoire : False
Position : 0
Valeur par défaut : Aucune
Accepte les entrées de pipeline : True (ByValue)
Accepte les caractères génériques : False
-Nom

Spécifiez le nom exact des Appareils non gérés que vous souhaitez récupérer.

Type : String[]
Ensembles de paramètres : Nom
Alias :
Obligatoire : Faux
Position : 0
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Vrai (ByValue)
Accepte les caractères génériques : Faux
-Relation
Filtre la liste récupérée par la relation d'entité des Appareils non gérés.

Type : Chaîne
Ensembles de paramètres : (Tous)
Alias :
Obligatoire : Faux
Position : Nommée
Get-NinjaUnmanagedDevice
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Faux
Accepte les caractères génériques : Faux
-Rôle

Récupère uniquement les appareils non gérés qui correspondent au rôle de l’appareil spécifié.

Type : Chaîne de caractères
Ensembles de paramètres : (Tous)
Alias :
Obligatoire : Faux
Position : Nommé
Valeur par défaut : Aucune
Accepte l'entrée du pipeline : Faux
Accepte les caractères génériques : Faux

Paramètres communs

Cette cmdlet prend en charge les paramètres communs suivants : -Debug, -ErrorAction, -ErrorVariable, -
InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -
Verbose, -WarningAction et -WarningVariable. Pour plus d'informations sur les paramètres communs, consultez le document Microsoft about_CommonParameters ( lien externe).

Entrées

Le Système.String[]

Vous pouvez transmettre par canalisation à cette applet de commande une chaîne de caractères contenant le nom d’un appareil non géré.
System.Int32[]
Vous pouvez transmettre par canalisation à cette applet de commande un entier contenant l’ID de l’appareil non géré.

Sorties

System.Object

Cette cmdlet renvoie un objet ou un tableau d'objets contenant les appareils non gérés que vous avez demandés.

Ressources complémentaires

Vous pouvez consulter ces ressources pour plus d’informations sur la création de scripts personnalisés et les sujets connexes :

FAQ

Pour aller plus loin