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

Powershell: Ninja-Property-Clear

  • Última actualización 21 de julio de 2026

Tema

En este artículo se explica cómo utilizar Ninja-Property-Clear para borrar el valor de un campo personalizado específico.

Si utilizas el módulo NinjaOne para PowerShell 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 Ninja-Property-Clear borra el valor de un campo personalizado especificado. Puedes especificar el nombre del campo mediante el parámetro -Name. El cmdlet eliminará cualquier valor existente del campo personalizado, restableciéndolo efectivamente a un estado vacío.

Solo se pueden restablecer mediante este cmdlet los campos con permisos de escritura de automatización. El valor del campo personalizado se borrará tras la próxima sincronización correcta con la plataforma NinjaOne, lo que suele ocurrir en unos minutos.

Sintaxis

Ninja-Property-Clear [[-Name] <Object>] [<CommonParameters>]

Ejemplos

Ejemplo 1: Borrar un campo personalizado de texto

PS C:> Ninja-Property-Clear -Name "exampleTextField"

El campo de texto se borrará tras la próxima sincronización correcta con la plataforma NinjaOne, lo que
suele ocurrir en unos minutos.

Parámetros

-Name

Especifica el nombre del campo personalizado que deseas borrar.

Tipo: Objeto
Conjuntos de parámetros: (Todos)
Alias:
Obligatorio: Falso
Posición: 0
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

Entradas

System.String

Este cmdlet no acepta entradas de la canalización. El parámetro -Name acepta un valor de cadena
que representa el nombre del campo personalizado que se va a borrar.

Salidas

Ninguna

  • Se requieren permisos de lectura de automatización para borrar cualquier valor de campo personalizado. Para obtener información sobre los permisos de los campos personalizados, consulta NinjaOne: Introducción».
  • El valor del campo personalizado se borrará tras la próxima sincronización correcta con la plataforma de
    de NinjaOne, lo que suele producirse 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