Powershell: Ninja-Property-Clear

Thema

In diesem Artikel wird erläutert, wie Sie mit Ninja-Property-Clear den Wert eines bestimmten benutzerdefinierten Feldes löschen 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-Clear“ löscht den Wert eines angegebenen benutzerdefinierten Feldes. Sie können den Feldnamen mithilfe des Parameters „-Name“ angeben. Das Cmdlet entfernt alle vorhandenen Werte aus dem benutzerdefinierten Feld und setzt es damit effektiv auf einen leeren Zustand zurück.

Nur Felder mit Schreibberechtigungen für die Automatisierung können mit diesem Cmdlet zurückgesetzt werden. Der Wert des benutzerdefinierten Feldes wird nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform gelöscht, was in der Regel innerhalb weniger Minuten erfolgt.

Syntax

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

Beispiele

Beispiel 1: Ein benutzerdefiniertes Textfeld löschen

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

Das Textfeld wird nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform gelöscht, was
in der Regel innerhalb weniger Minuten erfolgt.

Parameter

-Name

Geben Sie den Namen des benutzerdefinierten Feldes an, das Sie löschen möchten.

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

Eingaben

System.String

Dieses Cmdlet akzeptiert keine Eingaben aus der Pipeline. Der Parameter „-Name“ akzeptiert einen Zeichenfolgen
-Wert, der den Namen des benutzerdefinierten Feldes angibt, das gelöscht werden soll.

Ausgaben

Keine

Zum Löschen eines benutzerdefinierten Feldwerts sind Leseberechtigungen für die Automatisierung erforderlich. Informationen zu Berechtigungen für benutzerdefinierte Felder finden Sie unter „NinjaOne Custom Fields: Getting Started“.
Der Wert des benutzerdefinierten Feldes wird nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-
-Plattform gelöscht, was in der Regel innerhalb weniger Minuten erfolgt.

Weitere Ressourcen

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