Already a NinjaOne customer? Log in to view more guides and the latest updates.

Utilizzo di API e CLI con i tag dei dispositivi NinjaOne

  • Last Updated January 21, 2026

Argomento

Questo articolo spiega come utilizzare le API (Application Programming Interface) e le CLI (Command Line Interface) con i tag di sistema di NinjaOne. Per saperne di più sui tag NinjaOne, visitate il sito Getting Started with NinjaOne Device Tags.

Ambiente

Piattaforma NinjaOne

Descrizione

Utilizzate i tag del sistema NinjaOne per classificare i dispositivi (endpoint) al di là dei ruoli e dei campi personalizzati. I tag possono mostrare l'endpoint in una ricerca di dispositivi, assegnargli un'automazione specifica e condizioni aggiuntive e consentire di filtrare le query ai dispositivi con quel tag.

Selezionate una categoria per saperne di più:

Utilizzare l'API con i tag NinjaOne

Lo strumento NinjaOne CLI supporta le seguenti azioni con i tag delle risorse: 

  • Creare una o più etichette
  • Cancellare una o più etichette
  • Elenco dei tag assegnati a un dispositivo
  • Rimuovere l'assegnazione di un tag da un dispositivo
  • Assegnare un tag a un dispositivo
  • Unisci tag

API_tags.png
Immagine 1: Endpoint API pubblici per i tag delle risorse

Per ulteriori informazioni sull'utilizzo degli endpoint API, consultare la sezione Operazioni API pubbliche di NinjaOne. 

Utilizzare i comandi CLI con i tag NinjaOne

Avviare CLI o PowerShell sull'endpoint per eseguire le seguenti operazioni. Per sapere come lanciare la CLI o PowerShell, fate riferimento a Utilizzo dell'interfaccia della riga di comando (CLI) in NinjaOne.

Elenco di tutti i tag

Utilizzare i seguenti comandi per elencare tutti i tag. 

  • CLI: "tag_get"
  • PowerShell: "Get-NinjaTag"
ninjarrm-cli tag-get
Tag 1
Tag 2
Tag 3

ninjarmm-cli tag-get
Access to tags is possible only from automation script.

Immagine 2: Esempio di CLI (un elemento per riga) → Etichette dell'elenco

$Tags = Get-NinjaTag

$Tags
Tag 1
Tag 2
Tag 3

$Tag[1]
Tag 2

Immagine 3: Esempio di PowerShell (array di stringhe) → Elenco di tag

Assegnare un tag a un dispositivo

Utilizzare i seguenti comandi per assegnare un tag a un dispositivo. 

  • CLI: "tag-set"
  • PowerShell: "Imposta-NinjaTag"
ninjarmm-cli tag-set "Tag 1"

ninjarmm-cli tag-set "Non Existing Tag 1"
No tag with this name found

ninjarmm-cli tag-set "Tag 1"
Access to tags is possible only from automation script.

Figura 4: Esempio di CLI (un elemento per riga) → Assegnazione dei tag

Set-NinjaTag "Tag 1"
Set-NinjaTag -Name "Tag 1"

Set-NinjaTag "Non Existing Tag 1"
No tag with this name found

Immagine 5: Esempio PowerShell (array di stringhe) → Assegnazione dei tag

Rimuovere un'etichetta da un dispositivo

Utilizzare i seguenti comandi per rimuovere un tag da un dispositivo.

  • CLI: "tag-clear"
  • PowerShell: "Rimuovi-NinjaTag"
ninjarmm-cli tag-clear "Tag 1"

ninjarmm-cli tag-clear "Non Existing Tag 1"
No tag with this name found

ninjarmm-cli tag-clear "Tag 1"
Access to tags is possible only from automation script.

Figura 6: Esempio di CLI (un elemento per riga) → Rimuovere i tag

Remove-NinjaTag "Tag 1"
Remove-NinjaTag -Name "Tag 1"

Remove-NinjaTag "Non Existing Tag 1"
No tag with this name found

Immagine 7: Esempio PowerShell (array di stringhe) → Rimuovi tag

Risorse aggiuntive:

Per ulteriori informazioni sui tag NinjaOne e sull'uso della CLI, consultare le seguenti risorse:

FAQ

Next Steps