Powershell: Ninja-Property-Optionen

Thema

In diesem Artikel wird erläutert, wie Sie mit Ninja-Property-Options gültige Werte für ein Dropdown- oder Mehrfachauswahl-Benutzerdefiniertes Feld für ein Gerät abrufen können.

Wenn Sie das NinjaOne-PowerShell-Modul außerhalb eines Automatisierungsskripts verwenden, müssen Sie möglicherweise die Ausführungsrichtlinie von PowerShell anpassen. Weitere Informationen zu Ausführungsrichtlinien finden Sie in der Dokumentation von Microsoft: Über Ausführungsrichtlinien ( externer Link).

Umgebung

NinjaOne
Microsoft PowerShell

Beschreibung

Das Cmdlet „Ninja-Property-Options“ ruft gültige Werte für ein Dropdown- oder Mehrfachauswahl-Benutzerdefiniertes Feld eines Geräts ab. Sie können den Namen des benutzerdefinierten Felds mithilfe des Parameters „-Name“ angeben. Das Cmdlet gibt eine Liste gültiger Optionen im Format <guid>=<name> zurück, wobei <guid> die eindeutige Kennung der Option und <name> der Anzeigename der Option ist. Nur für Felder mit Lesezugriffsrechten für die Automatisierung können die Optionen mithilfe dieses Cmdlets abgerufen werden.

Syntax

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

Beispiele

Beispiel 1: Ein benutzerdefiniertes Dropdown-Feld

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

Wenn ein benutzerdefiniertes Dropdown-Feld angegeben wird, gibt das Cmdlet die gültigen Optionen für das Dropdown-Feld im Format <guid>=<name> zurück, wobei <guid> die eindeutige Kennung der Option und <name> der Anzeigename der Option ist.

Beispiel 2: Ein benutzerdefiniertes Feld mit Mehrfachauswahl

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

Wenn ein benutzerdefiniertes Feld mit Mehrfachauswahl angegeben wird, gibt das Cmdlet die gültigen Optionen für das Feld mit Mehrfachauswahl im Format <guid>=<name> zurück, wobei <guid> die eindeutige Kennung für die Option und <name> der Anzeigename der Option ist.

Beispiel 3: Ein benutzerdefiniertes Feld ohne Optionen

PS C:> Ninja-Property-Options -Name „exampleTextField“

Wenn ein benutzerdefiniertes Feld ohne Optionen, wie z. B. ein Textfeld, angegeben wird, gibt das Cmdlet keine Ausgabe zurück.

Parameter

-Name

Geben Sie den Namen des benutzerdefinierten Feldes an, für das Sie gültige Optionen abrufen möchten.

Typ: Objekt
Parametersätze: (Alle)
Aliase:
Erforderlich: False
Position: 0
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False

Eingaben

System.String

Das Cmdlet akzeptiert keine Eingaben aus der Pipeline. Der Parameter „-Name“ akzeptiert einen Zeichenfolgenwert, der den Namen des benutzerdefinierten Feldes angibt, für das Sie gültige Optionen abrufen möchten.

Ausgaben

System.String[]

Das Cmdlet gibt die gültigen Optionen für das angegebene benutzerdefinierte Feld im Format <guid>= <name> als Zeichenfolge oder als Array von Zeichenfolgen zurück, wenn mehr als eine Option verfügbar ist.

Dieses Cmdlet gilt nur für benutzerdefinierte Dropdown- und Mehrfachauswahlfelder. Wenn ein anderer Typ eines benutzerdefinierten Feldes angegeben wird, wird keine Ausgabe zurückgegeben.
Nur für Felder mit Lesezugriffsrechten für die Automatisierung können die Optionen mithilfe dieses Cmdlets abgerufen werden. Informationen zu Berechtigungen für benutzerdefinierte Felder finden Sie unter „NinjaOne Custom Fields: Getting Started“.

Weitere Ressourcen

Weitere Informationen zur Asset-Verwaltung und zu benutzerdefinierten Skripten finden Sie in den folgenden Ressourcen: