Powershell: Ninja-Property-Opzioni

Argomento

Questo articolo spiega come utilizzare Ninja-Property-Options per recuperare valori validi per un campo personalizzato a discesa o a selezione multipla relativo a un dispositivo.

Se si utilizza il modulo NinjaOne PowerShell al di fuori di uno script di automazione, potrebbe essere necessario modificare la politica di esecuzione di PowerShell. Per ulteriori informazioni sulle politiche di esecuzione, consultare la documentazione di Microsoft: Informazioni sulle politiche di esecuzione ( link esterno).

Ambiente

NinjaOne
Microsoft PowerShell

Descrizione

Il cmdlet Ninja-Property-Options recupera i valori validi per un campo personalizzato a menu a tendina o a selezione multipla relativo a un dispositivo. È possibile specificare il nome del campo personalizzato utilizzando il parametro -Name. Il cmdlet restituisce un elenco di opzioni valide nel formato <guid>=<name>, dove <guid> è l'identificatore univoco dell'opzione e <name> è il nome visualizzato dell'opzione. È possibile recuperare le opzioni solo per i campi con autorizzazioni di lettura per l’automazione utilizzando questo cmdlet.

Sintassi

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

Esempi

Esempio 1: un campo personalizzato a discesa

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

Quando viene specificato un campo personalizzato a menu a tendina, il cmdlet restituisce le opzioni valide per il campo a menu a tendina nel formato <guid>=<name>, dove <guid> è l'identificatore univoco dell'opzione e <name> è il nome visualizzato dell'opzione.

Esempio 2: un campo personalizzato a selezione multipla

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

Quando viene specificato un campo personalizzato a selezione multipla, il cmdlet restituisce le opzioni valide per il campo a selezione multipla nel formato <guid>=<nome>, dove <guid> è l'identificatore univoco dell'opzione e <nome> è il nome visualizzato dell'opzione.

Esempio 3: un campo personalizzato senza opzioni

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

Quando viene specificato un campo personalizzato privo di opzioni, come ad esempio un campo di testo, il cmdlet non restituisce alcun risultato.

Parametri

-Name

Specificare il nome del campo personalizzato per il quale si desidera recuperare le opzioni valide.

Tipo: Oggetto
Set di parametri: (Tutti)
Alias:
Obbligatorio: Falso
Posizione: 0
Valore predefinito: Nessuno
Accetta input dalla pipeline: Falso
Accetta caratteri jolly: Falso

Input

System.String

Il cmdlet non accetta input dalla pipeline. Il parametro -Name accetta un valore stringa che rappresenta il nome del campo personalizzato per il quale si desidera recuperare le opzioni valide.

Uscite

System.String[]

Il cmdlet restituisce le opzioni valide per il campo personalizzato specificato nel formato <guid>= <name> come stringa o come array di stringhe se è disponibile più di un'opzione.

Questo cmdlet è applicabile solo ai campi personalizzati a menu a tendina e a selezione multipla. Se viene specificato un tipo diverso di campo personalizzato, non verrà restituito alcun risultato.
È possibile recuperare le opzioni solo per i campi con autorizzazioni di lettura per l’automazione utilizzando questo cmdlet. Per informazioni sulle autorizzazioni relative ai campi personalizzati, consultare NinjaOne Custom Fields: Getting Started.

Risorse aggiuntive

Per ulteriori informazioni sulla gestione delle risorse e sugli script personalizzati, consultare le seguenti risorse: