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

PowerShell : Set-NinjaUnmanagedDevice

  • Dernière mise à jour 9 septembre 2026

Rubrique

Cet article explique comment utiliser Set-NinjaUnmanagedDevice pour mettre à jour les attributs d’un appareil non géré spécifié.

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 Set-NinjaUnmanagedDevice met à jour les attributs d’un périphérique non géré spécifié. Vous pouvez mettre à jour des attributs tels que les informations sur l’actif, les détails d’achat, les dates de garantie et les champs personnalisés. Les modifications apportées aux périphériques non gérés sont appliquées après la prochaine synchronisation réussie avec la plateforme NinjaOne, qui a généralement lieu en quelques minutes.

Syntaxe

Définir-NinjaUnmanagedDevice [-AssetID <CHAÎNE>] [-AssetSerialNumber <CHAÎNE>][-AssetStatus <CHAÎNE>][-EndOfLifeDate <DATEHEURE>] [-ExpectedLifetime <CHAÎNE>] [[-ID] <INT32>] [-Nom <CHAÎNE de caractères>][-PurchaseAmount <NOMBRE décimal>] [-PurchaseDate <DATE et heure>] [-WarrantyStartDate<DATE et heure>][-WarrantyEndDate <DATE et heure>] [-CustomFieldHashtable <TABLE de hachage>] [-Force][-WhatIf] [-Confirmer][<COMMONPARAMETERS>]

Exemples

Exemple 1 : modification à l’aide de propriétés individuelles

PS C:> Définir Set-NinjaUnmanagedDevice -ID 1314 -PurchaseAmount 100.00

Le montant d’achat du périphérique non géré portant l’ID 1314 est mis à jour à 100,00 $.

Exemple 2 : modification à l’aide d’un objet d’entrée

$LukesMonitor = @{
id = 1314
assetId = "8675309"
assetSerialNumber = "9565035"
assetStatus = "En cours d’utilisation"
endOfLifeDate = "2027-02-21"
expectedLifetime = "1 an"
name = "AEG-12345 sur le Bureau de Lukes"
purchaseAmount = 100,00
purchaseDate = "2026-02-21"
warrantyEndDate = "2027-02-21"
dateDébutGarantie = "21/02/2026"
valeursChampsPersonnalisés = @{
champTexteExemple = "Valeur de mon champ texte"
}
}
PS C:> $LukesMonitor | Set-NinjaUnmanagedDevice

Les attributs du périphérique non géré portant l'ID 1314 sont mis à jour en fonction des valeurs fournies dans l'objet d'entrée.

Paramètres

-AssetID

Spécifiez un numéro d’identification à associer au périphérique. Il ne s’agit pas de l’ID de l’appareil dans NinjaOne, mais il peut être utilisé pour suivre les informations relatives à l’actif.

Type : Chaîne de caractères
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : Nommé
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Faux
Accepte les caractères génériques : Faux
-AssetSerialNumber

Spécifiez le numéro de série de l'appareil à associer à celui-ci.

Type : Chaîne de caractères
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : Nommé
Valeur par défaut : Aucune
Accepte les entrées du pipeline : Faux
Accepte les caractères génériques : Faux
-AssetStatus

Spécifiez le statut actuel de l'actif. Les valeurs valides sont « Approvisionnement », « Mise à disposition », « Inventaire », « En cours d’utilisation », « Entretien », « Retiré » et « Archivé ».

Type : Chaîne de caractères
Jeux de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : Nommée
Valeur par défaut : Aucune
Accepte les entrées du pipeline : Faux
Accepte les caractères génériques : Faux
-Confirmer

Invite à confirmer avant d’exécuter la cmdlet.

Type : SwitchParameter
Ensembles de paramètres : (Tous)
Alias : cf
Obligatoire : Faux
Position : Nommé
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Faux
Accepte les caractères génériques : Faux
-CustomFieldHashtable

Définit les champs personnalisés du périphérique à l'aide d'une table de hachage. Utilisez le nom du champ personnalisé comme clé et la valeur correspondante comme valeur.

Type : Table de hachage
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : Nommé
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Faux
Accepte les caractères génériques : Faux
-EndOfLifeDate

Spécifiez la date à laquelle l’actif doit être considéré comme « en fin de vie » à l’aide d’un objet datetime.

Type : DateTime
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : Nommée
Valeur par défaut : Aucune
Accepte les entrées du pipeline : Faux
Accepte les caractères génériques : Faux
-ExpectedLifetime

Saisissez la durée de vie prévue de l'appareil. Veuillez noter que seules les valeurs « 1 an », « 2 ans », « 3 ans », « 4 ans » et « 5 ans » sont valides.

Type : Chaîne de caractères
Ensembles de paramètres : IndividualProperties
Alias :
Valeurs acceptées : 1 an, 2 ans, 3 ans, 4 ans, 5 ans
Obligatoire : Faux
Position : Nommée
Valeur par défaut : Aucune
Accepte les entrées du pipeline : Faux
Accepte les caractères génériques : Faux
-Force

Si le paramètre Confirm n’est pas spécifié, le paramètre Force remplace ShouldProcess et autorise la cmdlet à poursuivre le traitement.

Type : SwitchParameter
Jeux de paramètres : (Tous)
Alias :
Obligatoire : Faux
Position : Nommé
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Faux
Accepte les caractères génériques : Faux
-ID

Spécifiez l’ID de l’appareil NinjaOne non géré à mettre à jour. Vous pouvez récupérer l’ID de l’appareil à l’aide de la cmdlet Get-NinjaUnmanagedDevice.

Type : Int32
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : 0
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Faux
Accepte les caractères génériques : Faux
-InputObject

Spécifiez un objet à traiter au lieu d’utiliser des paramètres individuels. L’objet doit contenir une propriété correspondant à l’ID de l’appareil et peut, de manière facultative, inclure des propriétés pour n’importe lequel des autres attributs pouvant être mis à jour.

Type : PSObject
Ensembles de paramètres : Pipeline
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
-Nom

Entrez le nom du périphérique non géré que vous souhaitez créer.

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

Enregistrez le montant dépensé pour l'achat de l'appareil.

Type : Décimal
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : Nommé
Valeur par défaut : Aucune
Accepte les entrées du pipeline : Faux
Accepte les caractères génériques : Faux
-PurchaseDate

Spécifiez la date d'achat de l'appareil à l'aide d'un objet « datetime ».

Type : DateTime
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : Nommée
Valeur par défaut : Aucune
Accepte les entrées du pipeline : Faux
Accepte les caractères génériques : Faux
-WarrantyEndDate

Spécifiez la date de fin de la garantie de l'appareil à l'aide d'un objet DateTime.

Type : DateTime
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : False
Position : Nommée
Valeur par défaut : Aucune
Accepte les entrées du pipeline : False
Accepte les caractères génériques : False
-WarrantyStartDate

Spécifie la date de début de la garantie de l'appareil à l'aide d'un objet datetime.

Type : DateTime
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : False
Position : Nommée
Valeur par défaut : Aucune
Accepte les entrées de pipeline : False
Accepte les caractères génériques : False
-WhatIf

Affiche ce qui se passerait si la cmdlet était exécutée. La cmdlet n'est pas exécutée.

Type : SwitchParameter
Ensembles de paramètres : (Tous)
Alias : wi
Obligatoire : Faux
Position : Nommé
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Faux
Accepte les caractères génériques : Faux

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

System.Object

Le paramètre InputObject accepte un objet PSObject contenant les propriétés de l'appareil non géré à mettre à jour. L'objet doit inclure une propriété correspondant à l'ID de l'appareil et peut, de manière facultative, inclure des propriétés correspondant à n'importe lequel des autres attributs pouvant être mis à jour.

Le Système.String

La plupart des paramètres de cette applet de commande acceptent une entrée de type chaîne de caractères lorsque le paramètre InputObject n’est pas utilisé, comme Nom, Rôle et Relation.

Le Système.DateTime

Les paramètres tels que PurchaseDate, WarrantyStartDate et WarrantyEndDate acceptent des entrées de type DateTime lorsque le paramètre InputObject n’est pas utilisé.

Le Système.Decimal

Le paramètre PurchaseAmount accepte une valeur décimale lorsque le paramètre InputObject n’est pas utilisé.

Le Système.Hashtable

Le paramètre CustomFieldHashtable accepte une entrée de type table de hachage lorsque le paramètre InputObject n'est pas utilisé.

Sorties

System.Object

NinjaOne affichera le nouveau dispositif non géré une fois la synchronisation réussie, ce qui prend généralement quelques minutes.

Ressources complémentaires

Pour plus d’informations sur la gestion des actifs et les scripts personnalisés, consultez les ressources suivantes :

FAQ

Pour aller plus loin