¿Ya eres cliente de NinjaOne? Inicia sesión para ver más guías y las últimas actualizaciones.

Powershell: Establecer NinjaTag

  • Última actualización 21 de julio de 2026

Tema

En este artículo se explica cómo utilizar Set-NinjaTag para asignar una etiqueta del sistema específica al dispositivo actual.

Si utilizas el módulo de PowerShell de NinjaOne fuera de un script de automatización, es posible que tengas que ajustar la política de ejecución de PowerShell. Para obtener más información sobre las políticas de ejecución, consulta la documentación de Microsoft: Acerca de las políticas de ejecución ( enlace externo).

Entorno

  • NinjaOne
  • Microsoft PowerShell

Descripción

El cmdlet Set-NinjaTag asigna una o varias etiquetas de sistema especificadas al dispositivo actual. Las etiquetas de sistema son etiquetas predefinidas en la plataforma NinjaOne que pueden utilizarse para clasificar y gestionar dispositivos. El cmdlet añade las etiquetas especificadas al dispositivo actual sin afectar a ninguna etiqueta existente. 

Este cmdlet debe ejecutarse dentro de un script de automatización de Ninja para modificar las etiquetas del sistema asignadas. Los cambios en la asignación de etiquetas se aplican tras la siguiente sincronización correcta con la plataforma NinjaOne, lo que suele ocurrir en unos minutos.

Sintaxis

Set-NinjaTag [-Name] <String[]> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Ejemplos

Ejemplo 1: Asignación desde un script de automatización

PS C:> Set-NinjaTag -Name "IIS"

Asigna la etiqueta del sistema «IIS» al dispositivo actual.

Ejemplo 2: Asignación desde un terminal activo

PS C:> Set-NinjaTag -Name "IIS"
Set-NinjaTag : Solo se puede acceder a las etiquetas desde un script de automatización
En la línea: 1, carácter: 1
+ Set-NinjaTag -Name "IIS"
+ ~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.PowerShell.Commands.WriteErrorException,Set-NinjaTag

Las etiquetas solo se pueden configurar desde un script de automatización, por lo que se devuelve un mensaje de error al intentar ejecutar el cmdlet en una sesión de terminal activa.

Parámetros

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

Tipo: SwitchParameter
Conjuntos de parámetros: (Todos)
Alias: cf
Obligatorio: Falso
Posición: Nombrado
Valor predeterminado: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso
-Force

Si no se especifica «confirm» y el cmdlet solicitaría confirmación, este parámetro obliga al cmdlet a ejecutarse sin pedir confirmación.

Tipo: SwitchParameter
Conjuntos de parámetros: (Todos)
Alias:
Obligatorio: Falso
Posición: Nombrado
Valor predeterminado: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso
-Name

Especifica el nombre de las etiquetas del sistema que se asignarán al dispositivo actual.

Tipo: String[]
Conjuntos de parámetros: (Todos)
Alias:
Obligatorio: True
Posición: 0
Valor predeterminado: Ninguno
Acepta entrada de canalización: True (ByValue)
Acepta caracteres comodín: False
-WhatIf

Muestra lo que ocurriría si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo: SwitchParameter
Conjuntos de parámetros: (Todos)
Alias: wi
Obligatorio: Falso
Posición: Nombrada
Valor predeterminado: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

Parámetros comunes

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para obtener más información sobre los parámetros comunes, consulta el documento de Microsoft about_CommonParameters ( enlace externo).

Entradas

System.String[]

El cmdlet acepta una matriz de cadenas que representan los nombres de las etiquetas del sistema que se van a asignar al dispositivo actual.

Salidas

Ninguna

  • Este cmdlet debe ejecutarse dentro de un script de automatización de Ninja para modificar las etiquetas del sistema asignadas.
  • Los cambios en la asignación de etiquetas se aplican tras la siguiente sincronización correcta con la plataforma NinjaOne, lo que suele ocurrir en unos minutos.

Recursos adicionales

Para obtener más información sobre la gestión de activos y la creación de scripts personalizados, consulta los siguientes recursos:

FAQ

Próximos pasos