Powershell: Ninja-Property-Docs-Set-Single-Piped

Tema

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

Entorno

• NinjaOne
• Microsoft PowerShell

Descripción

Este cmdlet establece el valor de un campo personalizado especificado en un único documento mediante la canalización de PowerShell. Se puede especificar el nombre del campo mediante el parámetro -AttributeName y la plantilla del documento mediante el parámetro TemplateName. 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 en el único documento asociado a la plantilla indicada con el valor proporcionado.

Solo se pueden actualizar mediante este cmdlet los campos con permisos de escritura de automatización. El dispositivo que ejecute este cmdlet debe estar asignado como delegado de documentación para el documento que contenga el campo personalizado que se va a actualizar. El campo personalizado especificado en el documento se actualiza tras la siguiente sincronización satisfactoria con la plataforma NinjaOne, lo que suele producirse en unos minutos.

Sintaxis

Ninja-Property-Docs-Set-Single-Piped [[-TemplateName] <Object>] [[- AttributeName] <Object>] [[-Value] <Object>] [<CommonParameters>]

Ejemplo

Configuración de un campo personalizado con 199 999 caracteres

$alphabet = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMOPQRSTUVWXYZ1234567890"
$DesiredValue = New-Object System.Collections.Generic.List
for($i = 0; $i -lt 199999; $i++){
$DesiredValue.Add("$($alphabet[(Get-Random -Maximum
$alphabet.Length)])")
}
$CustomFieldValue = "$($DesiredValue -join '')"
PS C:> $CustomFieldValue | Ninja-Property-Docs-Set-Single-Piped -
TemplateName "Mi documento de ejemplo" -AttributeName "exampleWYSIWYG"

Los comandos en cadena 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 en «Mi documento de ejemplo».

Parámetros

-Nombre del atributo

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

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

-NombreDePlantilla

Indica el nombre de la plantilla del documento en el que deseas establecer el valor de
el campo personalizado especificado.

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

-Value

Define el valor que se va a establecer para el campo personalizado especificado.

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

Entradas

System.String

El cmdlet acepta entradas de cadena procedentes de la canalización, que se utilizan como valor que se va a establecer para el campo personalizado especificado. Los parámetros -TemplateName y -AttributeName aceptan valores de cadena que representan el nombre de la plantilla de documento y el nombre del campo personalizado, respectivamente, para los que se desea establecer un valor.

Salidas

Ninguna

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:

• Gestión de terminales de NinjaOne: Índice de comandos y artículos de PowerShell
• Interfaz de línea de comandos (CLI)
• Asignación de dispositivos como delegados de documentación
• Lectura o escritura en la documentación: automatización, CLI y API
• Interfaz de línea de comandos (CLI): campos y funcionalidades compatibles
• Campos personalizados de NinjaOne: primeros pasos