PowerShell : New-NinjaUnmanagedDevice

Rubrique

Cet article explique comment utiliser New-NinjaUnmanagedDevice pour créer un nouveau périphérique non géré avec les détails que vous avez spécifiés.

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 New-NinjaUnmanagedDevice crée un périphérique non géré et l'associe à une relation d'actif spécifiée avec le périphérique actuel. Le nouveau périphérique non géré est automatiquement attribué à la même organisation et au même emplacement que le périphérique géré associé.

De plus, vous pouvez renseigner divers champs facultatifs pour personnaliser l’appareil lors de sa création, tels que les dates de début et de fin de garantie ou d’autres détails pertinents. NinjaOne affichera le nouveau périphérique non géré une fois la synchronisation réussie, ce qui prend généralement quelques minutes.

Syntaxe

Propriétés individuelles (défaut)

NinjaUnmanagedDevice [[-Nom <CHAÎNE>] [-Rôle <CHAÎNE>] [-Relation<CHAÎNE>] [-AssetID <CHAÎNE>][-AssetSerialNumber <CHAÎNE>] [-AssetStatus <CHAÎNE>] [-EndOfLifeDate<DATEHEURE>] [-ExpectedLifetime <CHAÎNE>][-PurchaseAmount <DÉCIMAL>] [-PurchaseDate <DATEHEURE>] [-WarrantyStartDate<DATEHEURE>][-WarrantyEndDate <DATEHEURE>] [-CustomFieldHashtable <TABLE de hachage>] [-Force][-WhatIf] [-Confirmation][<COMMONPARAMETERS>]

Pipeline

New-NinjaUnmanagedDevice [[-InputObject] <OBJECT>] [-Force] [-WhatIf] [-Confirm] [<COMMONPARAMETERS>]

Exemples

Exemple 1 : Créer depuis des propriétés individuelles

PS C:> New-NinjaUnmanagedDevice -Name "AEG-12345 sur le bureau de Luke" -Role
"Moniteurs" -Relation "Connecté à"

Les informations minimales requises pour créer un périphérique non géré sont son nom, son rôle de périphérique non géré
et sa relation d'entité.

Exemple 2 : Créer depuis un objet d’entrée

$LukesMonitor = @{
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"
relation = "Connecté à"
role = "Moniteurs"
warrantyEndDate = "21/02/2027"
warrantyStartDate = "21/02/2026"
customFieldValues = @{
exampleTextField = "Valeur du champ de texte"
}
}
PS C:> New-NinjaUnmanagedDevice -InputObject $LukesMonitor

Pour spécifier des informations supplémentaires à l'aide du format d'objet d'entrée, formatez votre objet comme indiqué
dans l'exemple ci-dessus.

Exemple 3 : utilisation de la table de hachage des champs personnalisés

$MyCustomFieldValues = @{
exampleTextField = "Ma valeur de champ texte personnalisé"
}
PS C:> New-NinjaUnmanagedDevice -Name "AEG-12345 sur le bureau de Luke" -Role
"Moniteurs" -Relation "Connecté à" -CustomFieldHashtable
$MyCustomFieldValues

Si vous souhaitez utiliser des propriétés individuelles et spécifier certaines valeurs de champs personnalisés, vous pouvez utiliser l’
le paramètre CustomFieldHashtable.

Paramètres

-AssetID

Spécifiez un numéro d’identification à associer avec votre nouveau 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

Stocke les numéros de série des appareils non gérés.

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

-AssetStatus

Spécifie l'état actuel de l'actif. Les valeurs valides sont « Procurement », « Provisioning », «
», « Inventaire », « En cours d’utilisation », « Entretien », « Retired » et « Archivé ».

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

-Confirmer

Demande une confirmation 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

-ConfirmFieldHashtable

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 sa valeur correspondante comme valeur.

Type : Table de hachage
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : Nommée
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 de pipeline : Faux
Accepte les caractères génériques : Faux

-ExpectedLifetime

Saisissez la durée de vie prévue de l'appareil. Notez 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 la valeur
ShouldProcess et autorise la cmdlet à poursuivre son 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

-InputObject

Spécifie un objet à traiter au lieu d’utiliser des paramètres individuels.

Type : Object
Ensembles de paramètres : Pipeline
Alias :
Obligatoire : False
Position : 0
Valeur par défaut : Aucune
Accepte les entrées de pipeline : Vrai (ByValue)
Accepte les caractères génériques : False

-Nom

Saisissez 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 : 0
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ée
Valeur par défaut : Aucune
Accepte les entrées du pipeline : Faux
Accepte les caractères génériques : Faux

-PurchaseDate

Spécifie 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

-Relation

Spécifiez la relation entre l'appareil non géré et l'appareil actuel.

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

-Rôle

Spécifie le rôle de l’appareil non géré.

Type : Chaîne de caractères
Ensembles de paramètres : IndividualProperties
Alias :
Obligatoire : Faux
Position : Nommée
Valeur par défaut : Aucune
Accepte les entrées de 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 date-heure.

Type : DateTime
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

-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é
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 cmdlet prend en charge les paramètres communs suivants : Pour plus d'informations sur les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction et -WarningVariable. Reportez-vous à la documentation Microsoft about_CommonParameters ( lien externe).

Entrées

Le Système.Object

Cette applet de commande peut accepter un objet en entrée via le pipeline ou après avoir spécifié le paramètre InputObject.

System.String

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

Système.DateTime

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

Le Système.Décimal

Le paramètre PurchaseAmount accepte des valeurs décimales 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

Aucun

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 :