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

Utilice API y CLI con NinjaOne Device Tags

  • Last Updated January 21, 2026

Tema

Este artículo explica cómo utilizar API (Application Programming Interface) y CLI (Command Line Interface) con las etiquetas de sistema de NinjaOne. Obtenga más información sobre las etiquetas NinjaOne en Introducción a las etiquetas de dispositivos NinjaOne.

Entorno

Plataforma NinjaOne

Descripción

Utilice las etiquetas del sistema NinjaOne para clasificar los dispositivos (puntos finales) más allá de las funciones y los campos personalizados. Las etiquetas pueden mostrar el punto final en una búsqueda de dispositivos, asignarle una automatización específica y condiciones adicionales, y permitirle filtrar las consultas a dispositivos con esa etiqueta.

Seleccione una categoría para obtener más información:

Utilizar API con NinjaOne Tags

La herramienta CLI de NinjaOne soporta las siguientes acciones con etiquetas de activos: 

  • Crear una o varias etiquetas
  • Eliminar una o varias etiquetas
  • Lista de etiquetas asignadas a un dispositivo
  • Eliminar una asignación de etiqueta de un dispositivo
  • Asignar una etiqueta a un dispositivo
  • Combinar etiquetas

API_tags.png
Imagen 1: Puntos finales de la API pública para etiquetas de activos

Consulte Operaciones de la API Pública de NinjaOne para obtener más información sobre el uso de los puntos finales de la API. 

Utilizar comandos CLI con etiquetas NinjaOne

Inicie CLI o PowerShell en su endpoint para realizar las siguientes operaciones. Para aprender cómo iniciar CLI o PowerShell, consulte Uso de la interfaz de línea de comandos (CLI) en NinjaOne.

Lista de etiquetas

Utilice los siguientes comandos para listar todas las etiquetas. 

  • 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.

Imagen 2: Ejemplo CLI (Un elemento por línea) → Etiquetas de la lista

$Tags = Get-NinjaTag

$Tags
Tag 1
Tag 2
Tag 3

$Tag[1]
Tag 2

Imagen 3: Ejemplo PowerShell (matriz de cadenas) → Etiquetas de lista

Asignar una etiqueta a un dispositivo

Utilice los siguientes comandos para asignar una etiqueta a un dispositivo. 

  • CLI: "conjunto de etiquetas"
  • PowerShell: "Set-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: Ejemplo CLI (Un elemento por línea) → Asignar etiquetas

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

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

Imagen 5: Ejemplo PowerShell (matriz de cadenas) → Asignar etiquetas

Eliminar una etiqueta de un dispositivo

Utilice los siguientes comandos para eliminar una etiqueta de un dispositivo.

  • CLI: "tag-clear"
  • PowerShell: "Remove-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.

Imagen 6: Ejemplo de CLI (un elemento por línea) → Eliminar etiquetas

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

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

Imagen 7: Ejemplo PowerShell (matriz de cadenas) → Eliminar etiquetas

Recursos adicionales:

Consulte los siguientes recursos para obtener más información sobre las etiquetas NinjaOne y el uso de la CLI:

FAQ

Next Steps