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

PowerShell : Get-NinjaUnmanagedDevice

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 politique d'exécution de PowerShell. Pour plus d'informations sur les politiques d'exécution, consultez la documentation de Microsoft : À propos des politiques d'exécution ( lien externe).

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.

Les périphériques non gérés doivent appartenir à la même organisation et se trouver au même emplacement que
leur périphérique géré associé.

Syntaxe

Get-NinjaUnmanagedDevice [[-Name]] [-Role] [-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
If no name, role, or relation are given, it returns all unmanaged devices with an asset relation
to the current device.
Example 2: Filter the List Using the Optional Parameters
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 : Connected to
role : Monitors
warrantyEndDate :
warrantyStartDate :

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

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 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[]
Parameter Sets: Id
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Nom

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

Type: String[]
Parameter Sets: Name
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Relation
Filtre la liste récupérée par la relation d’entité des appareils non gérés.

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Get-NinjaUnmanagedDevice
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Rôle

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

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Paramètres communs

Cette applet de commande 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 périphérique non géré.
System.Int32[]
Vous pouvez transmettre par canalisation à cette applet de commande un entier contenant l'ID de l'appareil.

Sorties

Le Système.Object

Cette applet de commande 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