PowerShell : Supprimer-NinjaTag

Rubrique

Cet article explique comment utiliser Remove-NinjaTag pour supprimer une balise système spécifiée d'un appareil.

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 Remove-NinjaTag supprime une ou plusieurs balises système spécifiées de l'appareil actuel. Les balises système sont des balises prédéfinies dans la plateforme NinjaOne qui peuvent être utilisées pour catégoriser et gérer les appareils. La cmdlet supprime la ou les balises spécifiées de l'appareil actuel sans affecter les autres balises attribuées.

Cette cmdlet doit être exécutée dans un script d'automatisation Ninja pour modifier les balises système attribuées. Les modifications apportées à l'attribution des balises sont appliquées après la prochaine synchronisation réussie avec la plateforme NinjaOne, qui a généralement lieu en quelques minutes.

Syntaxe

Remove-NinjaTag [-Name] <STRING[]> [-Force] [-WhatIf] [-Confirm] [<COMMONPARAMETERS>]

Exemples

Exemple 1 : suppression depuis un script d’automatisation

PS C:> Supprimer-NinjaTag -Nom "IIS"

La balise système spécifiée « IIS » est supprimée de l'appareil.

Exemple 2 : Suppression à partir d’un terminal actif

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

Les balises ne peuvent être supprimées 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

-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

-Force

Si le paramètre « confirm » n'est pas spécifié et que le cmdlet demanderait une confirmation, ce paramètre force le cmdlet à s'exécuter sans demander de confirmation.

Type : SwitchParameter
Ensembles 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

-Nom

Nom(s) de la ou des balises système à supprimer de l’appareil. Ce paramètre accepte un tableau de chaînes de caractères, ce qui vous permet de spécifier plusieurs balises à supprimer en une seule commande.

Type : String[]
Ensembles de paramètres : (Tous)
Alias :
Obligatoire : True
Position : 0
Valeur par défaut : Aucune
Accepte l'entrée de pipeline : True (ByValue)
Accepte les caractères génériques : False

-WhatIf

Montrer 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 : -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

Le Système.String[]

Tableau de chaînes de caractères représentant les noms des balises système à supprimer du périphérique. Cette entrée peut être fournie via le pipeline ou en tant que paramètre.

Sorties

Aucun

Cette cmdlet doit être exécutée dans un script d'automatisation Ninja pour modifier les étiquettes d'un appareil
.
Les modifications apportées à l’attribution des balises sont appliquées après la prochaine synchronisation réussie avec la plate-forme
NinjaOne, qui a généralement lieu en quelques minutes.

Ressources complémentaires

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