Powershell: Ninja-Property-Docs-Set

Thema

In diesem Artikel wird erläutert, wie Sie mit Ninja-Property-Docs-Setden Wert eines bestimmten benutzerdefinierten Feldes in einem Dokument festlegen können.

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

Umgebung

NinjaOne
Microsoft Powershell

Beschreibung

Das Cmdlet „Ninja-Property-Docs-Set“ legt den Wert eines angegebenen benutzerdefinierten Feldes in einem Dokument fest. Sie können den Feldnamen mit dem Parameter „-AttributeName“, das Dokument mit dem Parameter „-DocumentName“, die Dokumentvorlage mit dem Parameter „-TemplateId“ und den festzulegenden Wert mit dem Parameter „-AttributeValue“ angeben. Das Cmdlet aktualisiert den Wert des angegebenen benutzerdefinierten Feldes in dem Dokument, das der angegebenen Vorlage zugeordnet ist.

Mit diesem Cmdlet können nur Felder aktualisiert werden, für die Schreibberechtigungen für die Automatisierung vorliegen. Das Gerät, auf dem dieses Cmdlet ausgeführt wird, muss als Dokumentationsbeauftragter für das Dokument zugewiesen sein, das das zu aktualisierende Benutzerdefinierte Feld enthält. Das angegebene Benutzerdefinierte Feld im Dokument wird nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform aktualisiert, was in der Regel innerhalb weniger Minuten erfolgt.

Syntax

Ninja-Property-Docs-Set [[-TemplateId] <OBJECT>] [[-DocumentName] <OBJECT>] [[-AttributeName] <OBJECT>] [[-AttributeValue] <OBJECT>] [<COMMONPARAMETERS>]

Beispiel

Einstellen eines Werts für ein benutzerdefiniertes Feld in einem Dokument

PS C:> Ninja-Property-Docs-Set -TemplateId "12345" -DocumentName "Mein
Beispieldokument" -AttributeName "exampleTextField" -AttributeValue "Neuer
Wert"

Das angegebene benutzerdefinierte Feld im Dokument wird nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform, die in der Regel innerhalb weniger Minuten erfolgt, auf „Neuer Wert“ aktualisiert.

Parameter

-AttributeName

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: 2
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: Falsch
Platzhalterzeichen akzeptieren: Falsch

-AttributeValue

Legen Sie den Wert fest, den Sie für das angegebene benutzerdefinierte Feld einstellen möchten. Der angegebene Wert sollte mit dem Typ des zu aktualisierenden benutzerdefinierten Feldes kompatibel sein (z. B. Text, Dropdown, Mehrfachauswahl).

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

-DocumentName

Geben Sie den Namen des Dokuments an, das das benutzerdefinierte Feld enthält, das Sie festlegen möchten.

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

-TemplateId

Legen Sie die ID der Dokumentvorlage fest, die dem Dokument zugeordnet ist, das das benutzerdefinierte Feld „
“ enthält, das Sie festlegen möchten.

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

Eingaben

System.String

Dieses Cmdlet akzeptiert keine Eingaben aus der Pipeline. Die Parameter -TemplateId, -DocumentName, -AttributeName und -AttributeValue akzeptieren Zeichenfolgenwerte, die jeweils die ID der Dokumentvorlage, den Namen des Dokuments, den Namen des benutzerdefinierten Felds und den für das benutzerdefinierte Feld festzulegenden Wert darstellen.

Ausgaben

Kein(e)

Das Gerät, auf dem dieses Cmdlet ausgeführt wird, muss als Dokumentationsdelegierter für das Dokument zugewiesen sein, dessen benutzerdefiniertes Feld aktualisiert werden soll.
Mit diesem Cmdlet können nur Felder aktualisiert werden, für die Schreibberechtigungen für Automatisierungen vorhanden sind. Informationen zu Berechtigungen für benutzerdefinierte Felder finden Sie unter „NinjaOne Custom Fields: Erste Schritte“.
Das angegebene benutzerdefinierte Feld im Dokument 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: