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

Powershell: Ninja-Property-Set-Piped

  • Última actualización 9 de septiembre de 2026

Tema

En este artículo se explica cómo utilizar Ninja-Property-Set-Piped para establecer el valor de un campo personalizado específico de un dispositivo mediante la canalización de PowerShell.

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 políticas de ejecución ( enlace externo).

Entorno

  • NinjaOne
  • Microsoft Powershell

Descripción

El cmdlet Ninja-Property-Set-Piped establece el valor de un campo personalizado específico del dispositivo mediante la canalización de PowerShell. Se puede especificar el nombre del campo personalizado mediante el parámetro -Name. El valor se puede proporcionar a través de la canalización o mediante el parámetro -Value. El cmdlet actualiza el valor del campo personalizado especificado para el dispositivo con el valor proporcionado.

Solo se pueden actualizar mediante este cmdlet los campos con permisos de escritura de automatización. El campo personalizado especificado se actualiza después de la siguiente sincronización correcta con la plataforma NinjaOne, lo que suele ocurrir en unos minutos.

Sintaxis

Ninja-Property-Set-Piped [[-Name] <OBJECT>] [[-Value] <OBJECT>] [<COMMONPARAMETERS>]

Ejemplos

Ejemplo 1: Configuración de un campo personalizado con 199 999 caracteres

$alphabet = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMOPQRSTUVWXYZ1234567890"
$DesiredValue = New-Object System.Collections.Generic.Lista[String]
para ($i = 0; $i -lt 199999; $i++){
$DesiredValue.Add("$($alphabet[(Get-Random -Máximo
$alphabet.Length)])")
}
$CustomFieldValue = "$($DesiredValue -join '')"
PS C:> Ninja-Property-Set-Piped -Name "exampleWYSIWYG" -Value
$CustomFieldValue

Los comandos en pipeline se pueden utilizar para establecer el valor de un campo personalizado en una cadena larga, como una de 199 999 caracteres, que es la longitud máxima para un campo personalizado WYSIWYG. En este ejemplo, se genera una cadena aleatoria de 199 999 caracteres y se establece como valor del campo personalizado «exampleWYSIWYG».

Ejemplo 2: Soporte para el canalizador

$alphabet = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMOPQRSTUVWXYZ1234567890"
$DesiredValue = New-Object System.Collections.Generic.Lista[String]
para ($i = 0; $i -lt 199999; $i++){
$DesiredValue.Agregar("$($alphabet[(Get-Random -Máximo
$alphabet.Length)])")
}
$CustomFieldValue = "$($DesiredValue -join '')"
PS C:>$CustomFieldValue | Ninja-Property-Set-Piped -Name "exampleWYSIWYG"

Los comandos en pipa se pueden utilizar para establecer el valor de un campo personalizado en una cadena larga, como 199 999 caracteres, que es la longitud máxima para un campo personalizado WYSIWYG. En este ejemplo, se genera una cadena aleatoria de 199 999 caracteres y se establece como valor del campo personalizado «exampleWYSIWYG».

Parámetros

-Nombre

Especifica el nombre del campo personalizado para el que deseas establecer un valor.

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

Especifica el valor que se va a establecer para el campo personalizado indicado.

Tipo: Objeto
Conjuntos de parámetros: (Todos)
Alias:
Requerido: Falso
Posición: 1
Valor por defecto: Ninguno
Acepta entrada del pipeline: Verdadero (Por valor)
Acepta caracteres comodín: Falso

Entradas

Sistema.String

El cmdlet acepta entradas de cadena procedentes de la canalización para el parámetro -Value, que representa el valor que se va a establecer para el campo personalizado especificado. El parámetro -Name acepta un valor de cadena que representa el nombre del campo personalizado para el que se desea establecer un valor, pero no acepta entradas de la canalización.

Salidas

Ninguno

  • Solo es posible recuperar las opciones de los campos que cuenten con permisos de escritura de automatización mediante este cmdlet. Para obtener información sobre los permisos de los campos personalizados, consulta «Campos personalizados de NinjaOne: Primeros pasos».
  • El campo personalizado especificado se actualiza después de la siguiente sincronización exitosa con la plataforma «
    » 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