Powershell: Set-NinjaProperty

Thema

In diesem Artikel wird erläutert, wie Sie mit „Set-NinjaProperty“ den Wert eines benutzerdefinierten Feldes anhand seines Namens und Typs festlegen können.

Wenn Sie das NinjaOne-PowerShell-Modul außerhalb eines Skripts für die Automatisierung 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

Mit dem Cmdlet „Set-NinjaProperty“ können Sie den Wert eines benutzerdefinierten Feldes festlegen, indem Sie dessen Namen, Typ und Wert angeben. Wenn ein Typ angegeben wird, konvertiert das Cmdlet den bereitgestellten Wert automatisch in ein Format, das mit dem angegebenen Feldtyp kompatibel ist. Wenn beispielsweise ein „DateTime“-Objekt bereitgestellt wird und der Typ „Date“ ist, konvertiert das Cmdlet den Wert in einen Unix-Epochen-Zeitstempel, bevor das Feld gesetzt wird.

Dieses Cmdlet unterstützt außerdem das Festlegen von Werten für Dropdown- und Mehrfachauswahlfelder unter Verwendung von Feldnamen anstelle von GUIDs. Zu den unterstützten Feldtypen gehören: Kontrollkästchen, „Date“, „Date“, „DateTime“, „Dezimal“, „
“, „Dropdown“, „E-Mail“, „Integer“, „IP-Adresse“, „MultiLine“, „MultiSelect“, „Phone“, „Secure“, „Text“, „Time“, „URL“ und „WYSIWYG“.

Nur Felder mit Schreibberechtigungen für Automatisierungen können mit diesem Cmdlet aktualisiert werden. Das angegebene benutzerdefinierte Feld wird nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform aktualisiert, was in der Regel innerhalb weniger Minuten erfolgt. Das Gerät, auf dem dieses Cmdlet ausgeführt wird, muss ein Dokumentdelegat für das Dokument sein, das das benutzerdefinierte Feld enthält, wenn der Parameter „-DocumentName“ verwendet wird.

Syntax

Set-NinjaProperty [-Name] <STRING> [[-Value] <OBJECT>] [[-Type] <STRING>] [[-DocumentName] <STRING>] [-Force] [-WhatIf] [-Confirm] [<COMMONPARAMETERS>]

Beispiele

Beispiel 1: Benutzerdefiniertes Kontrollkästchen-Feld

Set-NinjaProperty -Name „deployed“ -Value $True -Typ „Kontrollkästchen“

Setzt das benutzerdefinierte Feld „deployed“ auf „true“. Zulässige Checkbox-Werte: 0, 1, True, False oder ein boolescher Wert.

Beispiel 2: Benutzerdefiniertes Feld „Datum“

$DeploymentDate = Get-Date -Year „2026“ -Month „02“ -Tag „01“ -Stunde „0“ -
Minute „0“ -Sekunde „0“
Set-NinjaProperty -Name „deploymentDate“ -Value $DeploymentDate -Type „Datum“

Einstellt das benutzerdefinierte Feld „deploymentDate“ auf das angegebene Datum. Zulässige Datumswerte: DateTime-Objekte oder Zeichenfolgen, die in DateTime konvertiert werden können.

Beispiel 3: Benutzerdefiniertes Feld für Datum und Uhrzeit

$LastSeen = Get-Date -Year "2026" -Monat "02" -Tag "02" -Stunde "13" -Minute
"0" -Sekunde "0"
Set-NinjaProperty -Name "lastSeen" -Value $LastSeen -Type "DateTime"

Setzt das benutzerdefinierte Feld „lastSeen“ auf das angegebene Datum und die angegebene Uhrzeit. Zulässige Datums- und Uhrzeitwerte: DateTime-Objekte oder Zeichenfolgen, die in DateTime konvertiert werden können.

Beispiel 4: Benutzerdefiniertes Dezimalfeld

PS C:> Set-NinjaProperty -Name „pi“ -Value 3.14 -Type „Dezimal“

In diesem Beispiel wird das benutzerdefinierte Dezimalfeld „pi“ auf 3,14 gesetzt. Zulässige Dezimalwerte: Beliebige Zahlen im Bereich von -9999999,999999 bis 9999999,999999.

Beispiel 5: Benutzerdefiniertes Dropdown-Feld

PS C:> Set-NinjaProperty -Name „favoriteBand“ -Value „Mötley Crüe“ -Typ
„Dropdown“

In diesem Beispiel wird das benutzerdefinierte Drop-down-Feld „favoriteBand“ unter Verwendung des Optionsnamens „
“ anstelle der GUID auf „Mötley Crüe“ gesetzt. Zulässige Dropdown-Werte: Der Name einer der vordefinierten Optionen für das Feld.

Beispiel 6: Benutzerdefiniertes Feld für E-Mails

PS C:> Set-NinjaProperty -Name „supportEmail“ -Value „[email protected]“
-Typ „E-Mail“

In diesem Beispiel wird das benutzerdefinierte E-Mail-Feld „supportEmail“ auf „[email protected]“ gesetzt. Zulässige E-Mail-Werte: Jede Zeichenfolge, die dem offiziellen RFC 5322-Standard für E-Mail-Adressen entspricht.

Beispiel 7: Benutzerdefiniertes Feld vom Typ „Ganze Zahl“

PS C:> Set-NinjaProperty -Name „favoriteNumber“ -Value „42“ -Typ „Ganze Zahl“

In diesem Beispiel wird das benutzerdefinierte Feld „favoriteNumber“ auf 42 gesetzt. Zulässige Ganzzahlwerte: Jede ganze Zahl im Bereich von -2147483648 bis 2147483647.

Beispiel 8: Benutzerdefiniertes Feld für IP-Adressen

PS C:> Set-NinjaProperty -Name „primaryDNS“ -Wert „1.1.1.1“ -Typ
„IPAddress“

In diesem Beispiel wird das benutzerdefinierte Feld „primaryDNS“ (IP-Adresse) auf „1.1.1.1“ gesetzt. Zulässige IP-Adresswerte: Jede Zeichenfolge, die eine gültige IPv4- oder IPv6-Adresse darstellt.

Beispiel 9: Mehrzeiliges Benutzerdefiniertes Feld

PS C:> Set-NinjaProperty -Name "exampleMultiline" -Wert "Zeile 1`n`nZeile 3"
-Typ "MultiLine"

In diesem Beispiel wird das mehrzeilige benutzerdefinierte Feld „exampleMultiline“ auf eine Zeichenfolge mit mehreren Textzeilen
gesetzt. Zulässige Werte für mehrzeilige Felder: Irgendeine Zeichenfolge, die kleiner als 10.000 Zeichen ist.

Beispiel 10: Benutzerdefiniertes Feld mit Mehrfachauswahl

PS C:> Set-NinjaProperty -Name „exampleMultiselect“ -Value („Wert 3“,
„Option 1“) -Typ „MultiSelect“

In diesem Beispiel wird das benutzerdefinierte Mehrfachauswahlfeld „exampleMultiselect“ auf „Wert 3“ und „Option 1“ gesetzt, wobei die Anzeigenamen anstelle von GUIDs verwendet werden. Zulässige Werte für die Mehrfachauswahl: Ein Array von Zeichenfolgen, die die Anzeigenamen der gültigen Optionen darstellen, die mit dem Cmdlet „Ninja-Property-Options“ ermittelt werden können.

Beispiel 11: Benutzerdefiniertes Feld „Telefon“

PS C:> Set-NinjaProperty -Name „supportNumber“ -Value „+18008675309“ -Type
„Telefon“

In diesem Beispiel wird das benutzerdefinierte Telefonfeld „supportNumber“ auf „+18008675309“ gesetzt. Zulässige Werte für „Phone“: Jede Zeichenfolge, die dem E.164-Standard für Telefonnummern entspricht, d. h. ein Pluszeichen, gefolgt von der Ländervorwahl und der Teilnehmernummer (z. B. +18008675309).

Beispiel 12: Sicheres benutzerdefiniertes Feld

PS C:> Set-NinjaProperty -Name „superSecretPassword“ -Value „Hunter42“ -
Type „Secure“

In diesem Beispiel wird das gesicherte Benutzerdefinierte Feld „superSecretPassword“ auf „Hunter42“ gesetzt. Zulässige Werte für gesicherte Felder: Jede Zeichenfolge mit weniger als 200 Zeichen.

Beispiel 13: Benutzerdefiniertes Feld

PS C:> Set-NinjaProperty -Name „exampleTextField“ -Wert „My Text Value“ -
Typ „Text“

In diesem Beispiel wird das benutzerdefinierte Feld „exampleTextField“ auf „My Text Value“ gesetzt. Zulässige Textwerte: Beliebige Zeichenfolgen, die kleiner als 200 Zeichen sind.

Beispiel 14: Benutzerdefiniertes Feld für die Zeit

$UpdateTime = Get-Date -Stunde "09" -Minute "0" -Zweitens "0"
PS C:> Set-NinjaProperty -Name "updateTime" -Value $UpdateTime -Type "Time"

In diesem Beispiel wird das benutzerdefinierte Feld „updateTime“ auf 9:00 AM gesetzt. Zulässige Zeitwerte: Ein „DateTime“-Objekt, das eine Zeit angibt, oder eine Zeichenfolge, die in ein „DateTime“-Objekt konvertiert werden kann.

Beispiel 15: Benutzerdefiniertes Feld für die URL

PS C:> Set-NinjaProperty -Name „exampleUrl“ -Wert
„https://www.ninjaone.com“ -Typ „URL“

In diesem Beispiel wird das benutzerdefinierte URL-Feld „exampleUrl“ auf „https://www.ninjaone.com“ gesetzt. Zulässige URL-Werte: Jede Zeichenfolge, die kleiner als 200 Zeichen ist und mit https:// beginnt.

Beispiel 16: Benutzerdefiniertes WYSIWYG-Feld

PS C:> Set-NinjaProperty -Name "exampleWYSIWYG" -Value "<H1
style='color:#f015ca'>Hello World</H1>" -Typ "WYSIWYG"

In diesem Beispiel wird das benutzerdefinierte WYSIWYG-Feld „exampleWYSIWYG“ auf „<H1 style='color:#f015ca'>Hello World</H1>“ gesetzt. Benutzerdefinierte WYSIWYG-Felder in der CLI akzeptieren HTML als Wert, was eine Rich-Text-Formatierung im benutzerdefinierten Feld ermöglicht. Es wird empfohlen, in Ihrem HTML-Code einfache Anführungszeichen zu verwenden, um zu vermeiden, dass Sie doppelte Anführungszeichen in Ihrer HTML-Zeichenkette escapen müssen, wenn Sie den Wert eines benutzerdefinierten WYSIWYG-Feldes festlegen. Zulässige WYSIWYG-Werte: Irgendeine Zeichenkette mit weniger als 199.999 Zeichen. Die Zeichenkette sollte gültiges HTML enthalten, um optimale Ergebnisse zu erzielen, und es wird empfohlen, in HTML einfache Anführungszeichen zu verwenden, um zu vermeiden, dass Sie doppelte Anführungszeichen in der HTML-Zeichenkette escapen müssen.

Parameter

-Name

Geben Sie den Namen des benutzerdefinierten Feldes für das Gerät oder die Dokumentation an, dessen Wert Sie festlegen möchten.

Typ: Zeichenkette
Parameter-Sätze: (Alle)
Aliase:
Erforderlich: True
Position: 1
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False
-Wert

-Wert

Geben Sie den Wert an, der für das angegebene benutzerdefinierte Feld eingestellt werden soll.

Typ: Objekt
Parametersätze: (Alle)
Aliase:
Erforderlich: Falsch
Position: 2
Standardwert: Keiner
Pipeline-Eingabe akzeptieren: Wahr (ByValue)
Platzhalterzeichen akzeptieren: Falsch

-Typ

Der Typ des benutzerdefinierten Feldes, der bestimmt, wie der angegebene Wert verarbeitet und konvertiert wird. Zu den unterstützten Typen gehören: „Kontrollkästchen“, „Datum“, „DateTime“, „Dezimal“, „Dropdown“, „E-Mail“, „Integer“, „IP-Adresse“, „MultiLine“, „MultiSelect“, „Phone“, „Secure“, „Text“, „Time“, „URL“ und „WYSIWYG“.

Typ: Zeichenfolge
Parameter-Sätze: (Alle)
Aliase:
Erforderlich: Falsch
Position: 3
Standardwert: Kein(e) Wert(e)
Pipeline-Eingabe akzeptieren: Falsch
Platzhalterzeichen akzeptieren: Falsch

-DocumentName

Geben Sie den Namen des Dokuments an, von dem der Wert für das angegebene Benutzerdefinierte Feld der Dokumentation übernommen werden soll.

Typ: Zeichenfolge
Parametersätze: (Alle)
Aliase:
Erforderlich: Falsch
Position: 4
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: Falsch
Platzhalterzeichen akzeptieren: Falsch

-Force

Wenn „confirm“ nicht angegeben ist und das Cmdlet eine Bestätigung anfordern würde, erzwingt dieser Parameter die Ausführung des Cmdlets ohne Bitte um Bestätigung.

Typ: SwitchParameter
Parametersätze: (Alle)
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: False
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-WhatIf

Einblendet, was passieren würde, wenn das Cmdlet ausgeführt würde. Das Cmdlet wird nicht ausgeführt.

Typ: SwitchParameter
Parameter-Sätze: (Alle)
Aliase: „wi“
Erforderlich: „False“
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: „False“
Platzhalterzeichen akzeptieren: „False“

-Bestätigen

Fordert Sie vorher zur Bestätigung an, bevor das Cmdlet ausgeführt wird.

Typ: SwitchParameter
Parametersätze: (Alle)
Aliase: cf
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

Gewöhnliche Parameter

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen zu allgemeinen Parametern finden Sie im Microsoft-Dokument „about_CommonParameters“ ( Externer Link).

Eingaben

Ausgaben

Wenn Sie keinen Typ angeben, versucht das Cmdlet, den Zeichenfolgenwert unverändert einzustellen. In den Beispielen zu „Ninja-Property-Set“ erfahren Sie, wie Werte verarbeitet werden, wenn kein Typ angegeben ist.
Werte aus Dropdown- und MultiSelect-Listen sind vor dem Einstellen anhand vordefinierter Optionen validiert.
Wird ein ungültiger Typ angegeben, wird eine Warnung angezeigt.
Nicht trennbare Leerzeichen sind bei „WYSIWYG“-Typen automatisch durch das HTML-Äquivalent   ersetzt.
Nur bei Feldern mit Schreibberechtigungen 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: Erste Schritte“.
Das angegebene benutzerdefinierte Feld wird nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform aktualisiert, was in der Regel innerhalb weniger Minuten erfolgt.

Zusätzliche Ressourcen

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