PowerShell : Options-NinjaTag

Rubrique

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

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 depuis 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 depuis un terminal actif

PS C:> Options-NinjaTag
Options-NinjaTag : l'accès aux étiquettes 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

Texte

Titre

Texte

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

Aucun

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 complé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 étiquettes 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 d'appareils en tant que délégués de documentation
• Lecture/é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