Powershell: Ninja-Property-Docs-Opzioni-Single

Argomento

Questo articolo spiega come utilizzare Ninja-Property-Docs-Options-Singleper recuperare valori validi per un campo personalizzato a menu a tendina o a selezione multipla in un singolo documento.

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

Questo cmdlet recupera i valori validi per un campo personalizzato a menu a tendina o a selezione multipla in un singolo documento. È possibile specificare il nome del campo utilizzando il parametro -AttributeName e il documento utilizzando il parametro -TemplateName. 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 documento con autorizzazioni di lettura per l’automazione utilizzando questo cmdlet.

Sintassi

Ninja-Property-Docs-Opzioni-Single [[-TemplateName] <OBJECT>] [[- AttributeName] <OBJECT>] [<COMMONPARAMETERS>]

Esempi

Esempio 1: un campo personalizzato a menu a tendina

PS C:> Ninja-Property-Docs-Options-Single -TemplateName "My Example
Document" -AttributeName "exampleDropdown"
09d9ef8e-3cdf-4fb2-baf6-9b78b46643a9=Esempio di opzione 3
1ff0944e-2bc8-4681-909b-688e77db1cae=Esempio di Opzione 2
61010919-654f-4448-ba15-48a160d42f44=Cinese semplificato
bd182518-e0ca-4a50-9afb-f9542c1e7d08=Mötley Crüe
c2444bd4-2e75-4acf-944d-b73afd66b27f=Esempio Opzione 1

Quando viene specificato un campo personalizzato a discesa, il cmdlet restituisce le opzioni valide per il campo a discesa 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-Docs-Options-Single -TemplateName "My Example
Document" -AttributeName "exampleMultiSelect"
1e6bcc4a-0272-414e-a77c-4109ef79f86e=Opzione 1
3e08d167-e830-41e7-ae8f-1128e22b00a9=Opzione 3
4f4f73ba-0d69-4518-a78b-9ca554471b8e=Opzione 2
680e655d-0b66-4dba-a96e-dcee77ddd1e4=Cinese semplificato

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

Esempio 3: un campo personalizzato senza opzioni

PS C:> Ninja-Property-Docs-Options-Single -TemplateName "My Example
Document" -AttributeName "exampleTextField"

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

Parametri

-AttributeName

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

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

-TemplateName

Specificare il nome del singolo documento che contiene il 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

Il sistema.String

Il cmdlet non accetta input dalla pipeline. I parametri -TemplateName e -AttributeName accettano valori di tipo stringa che rappresentano, rispettivamente, il nome del singolo documento e il nome del Campo personalizzato per i quali si desidera recuperare le opzioni valide.

Uscite

System.String[]

Il cmdlet restituisce le opzioni valide per il campo personalizzato specificato nel singolo documento 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 di campo personalizzato
diverso, non verrà restituito alcun output.
È possibile recuperare le opzioni dei campi documento solo se dispongono di autorizzazioni di lettura per l’automazione. Per informazioni sulle autorizzazioni relative ai campi personalizzati, consultare la guida introduttiva “NinjaOne Custom Fields: Inizia”.

Risorse aggiuntive

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