PowerShell : Get-NinjaUnmanagedDevice

Sujet

Cet article explique comment utiliser Get-NinjaUnmanagedDevice pour récupérer les périphériques non gérés associés au périphérique actuel.

Environnement

• NinjaOne
• Microsoft PowerShell

Description

La cmdlet Get-NinjaUnmanagedDevice récupère une liste des périphériques non gérés associés
au périphérique 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 périphérique non géré, à l'exception des champs sécurisés.

Syntaxe

Get-NinjaUnmanagedDevice [[-Name] ] [-Role ] [-Relation ] [ ]

Exemples

Exemple 1 : récupérer tous les périphériques 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 : Écrans
warrantyEndDate :
warrantyStartDate :

Si aucun nom, rôle ou relation n’est spécifié, la 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

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 périphériques 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 périphérique non géré. Notez que cet ID est différent 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 périphériques non gérés que vous souhaitez récupérer.

Type : String[]
Ensembles de paramètres : Name
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

-Relation
Filtre la liste récupérée en fonction de la relation d'entité des périphériques non gérés.

Type : Chaîne de caractères
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

-Role

Récupère uniquement les périphériques non gérés qui correspondent au rôle de périphérique non géré 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

System.String[]

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

Sorties

System.Object

Cette applet de commande renvoie un objet ou un tableau d'objets contenant les périphériques non gérés que vous avez demandés.

Ressources supplémentaires

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

• NinjaOne Endpoint Management : Index des commandes PowerShell et des articles
• Gestion des actifs informatiques (ITAM)
• NinjaOne ITAM : Pour commencer
• NinjaOne ITAM : Utilisation des appareils non gérés dans NinjaOne
• NinjaOne ITAM : Créer un appareil non géré via l'interface de ligne de commande (CLI)