PowerShell : Options-NinjaTag

Rubrique

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 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 réellement 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 que depuis 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 ; un message d'erreur s'affiche donc 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 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

Aucun

Sorties

Le Système.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 
• Pour commencer avec les balises de périphérique NinjaOne
• Utilisation de l'API et de l'interface en ligne de commande (CLI) avec les étiquettes de périphériques NinjaOne
• Interface de ligne de commande (CLI) 
• Attribution d'appareils 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