PowerShell : Options-NinjaTag

Sujet

Cet article explique comment utiliser Options-NinjaTag pour répertorier toutes les balises système possibles pour un périphérique.

Environnement

• NinjaOne
• Microsoft PowerShell

Description

La cmdlet Options-NinjaTag récupère la liste de toutes les balises système pouvant être attribuées à un périphérique
. Cette cmdlet doit être exécutée au sein d’un script d’automatisation Ninja pour accéder aux informations relatives aux balises.

Syntaxe

Options-NinjaTag [<CommonParameters>]

Exemples

Exemple 1 : Récupération à partir d’un script d’automatisation

PS C:> Options-NinjaTag
IIS
Stuff
Serveur de fax
Déduplication des données
Serveur de fichiers
ADDS
DNS
Éligible à l'ESU
Réplication DFS

Toutes les balises système possibles pour un périphérique sont répertoriées dans la sortie. Les balises effectivement attribuées au périphérique peuvent être récupérées à l'aide de la cmdlet Get-NinjaTag.

Exemple 2 : récupération à partir d’un terminal actif

PS C:> Options-NinjaTag
Options-NinjaTag : l'accès aux balises n'est possible qu'à partir d'un script d'automatisation
À la ligne : 1, caractère : 1
+ Options-NinjaTag
+ ~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.PowerShell.Commands.WriteErrorException,Options-NinjaTag

Les balises ne sont accessibles qu’à partir d’un script d’automatisation ; par conséquent, un message d’erreur s’affiche lorsque l’on tente d’exécuter la cmdlet dans une session de terminal active.

Paramètres

Titre

text

Titre

texte

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

Aucune

Sorties

System.String[]

Lorsqu’elle est exécutée, cette cmdlet renvoie un tableau de chaînes de caractères représentant toutes les balises système pouvant être attribuées à un périphérique.

Ressources supplémentaires

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

• NinjaOne : Index des commandes PowerShell et des articles 
• Premiers pas avec les balises de périphériques NinjaOne
• Utilisation de l'API et de l'interface en ligne de commande (CLI) avec les balises de périphériques NinjaOne
• Interface de ligne de commande (CLI) 
• Attribution de périphériques en tant que délégués de documentation
• Lecture ou écriture dans la documentation : automatisation, CLI et API
• Interface de ligne de commande (CLI) : champs et fonctionnalités pris en charge
• Champs personnalisés NinjaOne : pour commencer