PowerShell : Ninja-Property-Clear

Sujet

Cet article explique comment utiliser Ninja-Property-Clear pour effacer la valeur d'un champ personnalisé spécifié.

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 Ninja-Property-Clear efface la valeur d’un champ personnalisé spécifié. Vous pouvez indiquer le nom du champ à l’aide du paramètre -Name. La cmdlet supprimera toute valeur existante du champ personnalisé, le réinitialisant ainsi à un état vide.

Seuls les champs disposant d’autorisations d’écriture en mode automatisé peuvent être réinitialisés à l’aide de cette cmdlet. La valeur du champ personnalisé sera effacée après la prochaine synchronisation réussie avec la plateforme NinjaOne, qui a généralement lieu en quelques minutes.

Syntaxe

Ninja-Property-Clear [[-Name] <Object>] [<CommonParameters>]

Exemples

Exemple 1 : effacer un champ personnalisé de type texte

PS C:> Ninja-Property-Clear -Name "exampleTextField"

Le champ de texte est effacé après la prochaine synchronisation réussie avec la plateforme NinjaOne, ce qui
se produit généralement en quelques minutes.

Paramètres

-Name

Spécifiez le nom du champ personnalisé que vous souhaitez effacer.

Type : Objet
Jeux de paramètres : (Tous)
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

Entrées

System.String

Cette cmdlet n'accepte pas d'entrée provenant du pipeline. Le paramètre -Name accepte une valeur de type chaîne de caractères
représentant le nom du champ personnalisé à effacer.

Sorties

Aucune

Des autorisations de lecture en mode automatisé sont requises pour effacer la valeur d’un champ personnalisé. Pour plus d’informations sur les autorisations relatives aux champs personnalisés, consultez la documentation « NinjaOne Custom Fields: Getting Started ».
La valeur du champ personnalisé sera effacée après la prochaine synchronisation réussie avec la plateforme d’
NinjaOne, qui a généralement lieu en quelques minutes.

Ressources supplémentaires

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