Sie sind bereits NinjaOne-Kunde? Melden Sie sich an, um weitere Leitfäden und die neuesten Updates zu sehen.

Powershell: Ninja-Property-Set-Piped

Thema

In diesem Artikel wird erläutert, wie Sie mit „Ninja-Property-Set-Piped“ den Wert eines bestimmten benutzerdefinierten Felds für ein Gerät mithilfe der PowerShell-Pipeline 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

Das Cmdlet „Ninja-Property-Set-Piped“ legt den Wert eines angegebenen benutzerdefinierten Gerätefelds über die PowerShell-Pipeline fest. Sie können den Namen des benutzerdefinierten Felds mit dem Parameter „-Name“ angeben. Der Wert kann über die Pipeline oder mithilfe des Parameters „-Value“ übergeben werden. Das Cmdlet aktualisiert den Wert des angegebenen benutzerdefinierten Felds für das Gerät mit dem übergebenen Wert.

Mit diesem Cmdlet können nur Felder aktualisiert werden, für die Schreibberechtigungen für die Automatisierung bestehen. Das angegebene benutzerdefinierte Feld wird nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform aktualisiert, was in der Regel innerhalb weniger Minuten geschieht.

Syntax

Ninja-Property-Set-Piped [[-Name] <OBJECT>] [[-Value] <OBJECT>] [<COMMONPARAMETERS>]

Beispiele

Beispiel 1: Festlegen eines benutzerdefinierten Feldes mit 199.999 Zeichen

$alphabet = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMOPQRSTUVWXYZ1234567890"
$DesiredValue = New-Object System.Collections.Generic.Liste[String]
für ($i = 0; $i -lt 199999; $i++){
$DesiredValue.Add("$($alphabet[(Get-Random -Maximum
$alphabet.Length)])")
}
$CustomFieldValue = "$($DesiredValue -join '')"
PS C:> Ninja-Property-Set-Piped -Name "exampleWYSIWYG" -Value
$CustomFieldValue

Mit Piped-Befehlen lässt sich der Wert eines benutzerdefinierten Feldes auf eine lange Zeichenfolge festlegen, beispielsweise 199.999 Zeichen – dies entspricht der maximalen Länge für ein benutzerdefiniertes WYSIWYG-Feld. In diesem Beispiel wird eine zufällige Zeichenfolge mit 199.999 Zeichen generiert und als Wert für das benutzerdefinierte Feld „exampleWYSIWYG“ festgelegt.

Beispiel 2: Support für Pipelines

$alphabet = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMOPQRSTUVWXYZ1234567890"
$DesiredValue = New-Object System.Collections.Generic.Liste[String]
for($i = 0; $i -lt 199999; $i++){
$DesiredValue.Hinzufügen("$($alphabet[(Get-Random -Maximum
$alphabet.Length)])")
}
$CustomFieldValue = "$($DesiredValue -join '')"
PS C:>$CustomFieldValue | Ninja-Property-Set-Piped -Name "exampleWYSIWYG"

Mit Piped-Befehlen lässt sich der Wert eines benutzerdefinierten Feldes auf eine lange Zeichenfolge festlegen, beispielsweise 199.999 Zeichen – dies entspricht der maximalen Länge für ein benutzerdefiniertes WYSIWYG-Feld. In diesem Beispiel wird eine zufällige Zeichenfolge mit 199.999 Zeichen generiert und als Wert für das benutzerdefinierte Feld „exampleWYSIWYG“ festgelegt.

Parameter

-Name

Geben Sie den Namen des benutzerdefinierten Feldes an, für das Sie einen Wert einstellen möchten.

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

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

Typ: Objekt
Parameter-Sätze: (Alle)
Aliase:
Erforderlich: Falsch
Position: 1
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: Wahr (ByValue)
Platzhalterzeichen akzeptieren: Falsch

Eingaben

System.String

Das Cmdlet akzeptiert Zeichenfolgen aus der Pipeline für den Parameter „-Value“, der den Wert angibt, der für das angegebene benutzerdefinierte Feld festgelegt werden soll. Der Parameter „-Name“ akzeptiert einen Zeichenfolgenwert, der den Namen des benutzerdefinierten Feldes angibt, für das Sie einen Wert festlegen möchten, akzeptiert jedoch keine Pipeline-Eingabe.

Ausgaben

Kein(e)

  • 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 geschieht.

Zusätzliche Ressourcen

Weitere Informationen zum Asset-Management und zu benutzerdefinierten Skripten finden Sie in den folgenden Ressourcen:

FAQ

Nächste Schritte