Powershell: Ninja-Propiedades-Opciones

Tema

En este artículo se explica cómo utilizar Ninja-Property-Options para recuperar valores válidos para un campo personalizado de menú desplegable o de selección múltiple de dispositivos.

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

Entorno

NinjaOne
Microsoft Powershell

Descripción

El cmdlet Ninja-Property-Options recupera los valores válidos de un campo personalizado de menú desplegable o de selección múltiple de un dispositivo. Puedes especificar el nombre del campo personalizado mediante el parámetro -Name. El cmdlet devuelve una lista de opciones válidas en el formato <GUID>=<NAME>, donde <GUID> es el identificador único de la opción y <NAME> es el nombre que se muestra de la opción. Solo se pueden recuperar las opciones de los campos con permisos de lectura de automatización usando este cmdlet.

Sintaxis

Ninja-Propiedades [[-Nombre] <OBJETO>] [<PARÁMETROS comunes>]

Ejemplos

Ejemplo 1: un campo personalizado desplegable

PS C:> Ninja-Property-Options -Name "exampleDropdown"
2a100199-4067-4332-8f4d-451e14b94a76=Mötley Crüe
9eccdedf-aefb-4d4b-92c3-e0fe03c305e2=Valor 1
cd7ec878-766d-4794-baa2-4328af9f06ce=101010101

Cuando se especifica un campo personalizado de menú desplegable, el cmdlet devuelve las opciones válidas para dicho campo en el formato <GUID>=<NOMBRE>, donde <GUID> es el identificador único de la opción y <NOMBRE> es el nombre que se muestra de la opción.

Ejemplo 2: Un campo personalizado de selección múltiple

PS C:> Ninja-Property-Options -Nombre "exampleMultiSelect"
154d90cf-3d4a-4e43-8b79-232ccd5b74a6=Valor 3
21aa863a-ddf1-4f5c-8811-4e98c45da96b=Mötley Crüe
834d0865-1c70-492b-ac11-73854fd0294d=Opción 1

Cuando se especifica un campo personalizado de selección múltiple, el cmdlet devuelve las opciones válidas para dicho campo en el formato <GUID>=<NOMBRE>, donde <GUID> es el identificador único de la opción y <NOMBRE> es el nombre de la pantalla de la opción.

Ejemplo 3: Un campo personalizado sin opciones

PS C:> Ninja-Property-Options -Nombre "exampleTextField"

Cuando se especifica un campo personalizado que no tiene opciones, como un campo de texto, el cmdlet no devuelve ninguna salida.

Parámetros

-Nombre

Especifica el nombre del campo personalizado para el que se desean recuperar las opciones válidas.

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

Entradas

Sistema.String

El cmdlet no acepta entradas de la canalización. El parámetro -Name acepta un valor de cadena que representa el nombre del campo personalizado para el que desea recuperar opciones válidas.

Salidas

Sistema.String[]

El cmdlet devuelve las opciones válidas para el campo personalizado especificado en el formato <GUID>= <NOMBRE> como una cadena o una matriz de cadenas si hay más de una opción disponible.

Este cmdlet solo es aplicable a campos personalizados de menú desplegable y de selección múltiple. Si se especifica un tipo diferente de campo personalizado, no se devolverá ninguna salida.
Solo se pueden recuperar las opciones de los campos con permisos de lectura de automatización mediante este cmdlet. Para obtener información sobre los permisos de los campos personalizados, consulta «Campos personalizados de NinjaOne: Primeros pasos».

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: