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

Powershell: Eliminar-NinjaTag

  • Última actualización 21 de julio de 2026

Tema

En este artículo se explica cómo utilizar Remove-NinjaTag para eliminar una etiqueta del sistema especificada de un dispositivo.

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 Remove-NinjaTag elimina una o varias etiquetas del sistema especificadas del dispositivo actual. Las etiquetas del sistema son etiquetas predefinidas en la plataforma NinjaOne que se pueden utilizar para clasificar y gestionar dispositivos. El cmdlet elimina las etiquetas especificadas del dispositivo actual sin afectar a ninguna otra etiqueta asignada.

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

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

Ejemplos

Ejemplo 1: Eliminar desde un script de automatización

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

La etiqueta del sistema especificada «IIS» se elimina del dispositivo.

Ejemplo 2: Eliminar desde un terminal activo

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

Las etiquetas solo se pueden eliminar 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

El nombre de las etiquetas del sistema que se van a eliminar del dispositivo. Este parámetro acepta una matriz de cadenas, lo que permite especificar varias etiquetas para eliminar en un único comando.

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: Nombrado
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[]

Una matriz de cadenas que representa los nombres de las etiquetas del sistema que se van a eliminar del dispositivo. Esta entrada se puede proporcionar a través de la canalización o como parámetro.

Salidas

Ninguna

  • Este cmdlet debe ejecutarse dentro de un script de automatización de Ninja para modificar las etiquetas de un dispositivo de
    .
  • 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