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

Powershell: Set-NinjaUnmanagedDevice

Thema

In diesem Artikel wird erläutert, wie Sie mit „Set-NinjaUnmanagedDevice“ die Attribute eines bestimmten nicht verwalteten Geräts aktualisieren 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 „Set-NinjaUnmanagedDevice“ aktualisiert die Attribute eines angegebenen nicht verwalteten Geräts. Sie können Attribute wie Bestandsinformationen, Kaufdetails, Garantiedaten und benutzerdefinierte Felder aktualisieren. Änderungen an nicht verwalteten Geräten werden nach der nächsten erfolgreichen Synchronisierung mit der NinjaOne-Plattform übernommen, was in der Regel innerhalb weniger Minuten erfolgt.

Syntax

Set-NinjaUnmanagedDevice [-AssetID <Zeichenfolge>] [-AssetSerialNumber <Zeichenfolge>][-AssetStatus <Zeichenfolge>][-EndOfLifeDate <Datum/Uhrzeit>] [-ExpectedLifetime <Zeichenfolge>] [[-ID] <Int32>] [-Name <Zeichenfolge>][-Kaufbetrag <Dezimalzahl>] [-Kaufdatum <Datum/Uhrzeit>] [-Garantiebeginn<Datum/Uhrzeit>][-Garantieende <Datum/Uhrzeit>] [-BenutzerdefinierteFeld-Hash-Tabelle <Hash-Tabelle>] [-Force][-WhatIf] [-Confirm][<AllgemeineParameter>]

Beispiele

Beispiel 1: Ändern mithilfe einzelner Eigenschaften

PS C:> Set-NinjaUnmanagedDevice -Id 1314 -PurchaseAmount 100.00

Der Kaufbetrag für das nicht verwaltete Gerät mit der ID 1314 wird auf 100,00 $ aktualisiert.

Beispiel 2: Ändern mithilfe eines Eingabeobjekts

$LukesMonitor = @{
id = 1314
assetId = "8675309"
assetSerialNumber = "9565035"
assetStatus = "In Gebrauch"
endOfLifeDate = "2027-02-21"
expectedLifetime = "1 Jahr"
name = "AEG-12345 auf Lukes Desktop"
purchaseAmount = 100,00
purchaseDate = "2026-02-21"
warrantyEndDate = "2027-02-21"
Garantiebeginn = „21.02.2026“
benutzerdefinierteFeldwerte = @{
BeispielTextfeld = „Mein Textfeldwert“
}
}
PS C:> $LukesMonitor | Set-NinjaUnmanagedDevice

Die Attribute des nicht verwalteten Geräts mit der ID 1314 werden anhand der im Eingabeobjekt angegebenen Werte aktualisiert.

Parameter

-AssetID

Geben Sie eine Identifikationsnummer an, die dem Gerät zugeordnet werden soll. Diese entspricht nicht der Geräte-ID in NinjaOne, kann jedoch zur Nachverfolgung von Asset-Informationen verwendet werden.

Typ: Zeichenfolge
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False
-AssetSerialNumber

Geben Sie die Seriennummer des Geräts an, die dem Gerät zugeordnet werden soll.

Typ: Zeichenfolge
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False
-AssetStatus

Geben Sie den aktuellen Status des Assets an. Gültige Werte sind „Beschaffung“, „Bereitstellung“, „Bestand“, „In Gebrauch“, „Wartung“, „Ausgemustert“ und „Archiviert“.

Typ: Zeichenfolge
Parametersätze: IndividualProperties
Aliase:
Erforderlich: Falsch
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: Falsch
Platzhalterzeichen zulassen: Falsch
-Confirm

Fordert Sie vor der Ausführung des Cmdlets zur Bestätigung auf.

Typ: SwitchParameter
Parametersätze: (Alle)
Aliase: cf
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False
-CustomFieldHashtable

Legt die benutzerdefinierten Felder des Geräts mithilfe einer Hash-Tabelle fest. Verwenden Sie den Namen des benutzerdefinierten Feldes als Schlüssel und den entsprechenden Wert als Wert.

Typ: Hashtable
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False
-EndOfLifeDate

Geben Sie das Datum an, an dem das Asset als „am Ende seiner Lebensdauer“ betrachtet werden soll, und zwar mithilfe eines Datetime-Objekts.

Typ: DateTime
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False
-ExpectedLifetime

Geben Sie die erwartete Lebensdauer des Geräts ein. Bitte beachten Sie, dass nur „1 Jahr“, „2 Jahre“, „3 Jahre“, „4 Jahre“ und „5 Jahre“ gültige Werte sind.

Typ: Zeichenfolge
Parametersätze: IndividualProperties
Aliase:
Zulässige Werte: 1 Jahr, 2 Jahre, 3 Jahre, 4 Jahre, 5 Jahre
Erforderlich: Falsch
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: Falsch
Platzhalterzeichen zulassen: Falsch
-Force

Wenn der Parameter „Confirm“ nicht angegeben ist, überschreibt der Parameter „Force“ den Parameter „ShouldProcess“ und ermöglicht es dem Cmdlet, die Verarbeitung fortzusetzen.

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

Geben Sie die NinjaOne-Geräte-ID des nicht verwalteten Geräts an, das aktualisiert werden soll. Sie können die Geräte-ID mithilfe des Cmdlets „Get-NinjaUnmanagedDevice“ abrufen.

Typ: Int32
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: 0
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False
-InputObject

Geben Sie ein zu verarbeitendes Objekt an, anstatt einzelne Parameter zu verwenden. Das Objekt muss eine Eigenschaft für die Geräte-ID enthalten und kann optional Eigenschaften für alle anderen Attribute enthalten, die aktualisiert werden können.

Typ: PSObject
Parametersätze: Pipeline
Aliase:
Erforderlich: False
Position: 0
Standardwert: Keine
Pipeline-Eingabe zulassen: True (ByValue)
Platzhalterzeichen zulassen: False
-Name

Geben Sie den Namen des nicht verwalteten Geräts ein, das Sie erstellen möchten.

Typ: Zeichenfolge
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False
-Kaufbetrag

Speichern Sie den Betrag, der für den Kauf des Geräts ausgegeben wurde.

Typ: Dezimalzahl
Parametersätze: IndividualProperties
Aliase:
Erforderlich: Falsch
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: Falsch
Platzhalterzeichen zulassen: Falsch
-PurchaseDate

Gibt das Datum an, an dem das Gerät gekauft wurde, unter Verwendung eines Datetime-Objekts.

Typ: DateTime
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False
-WarrantyEndDate

Geben Sie das Enddatum der Garantie für das Gerät mithilfe eines Datetime-Objekts an.

Typ: DateTime
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False
-WarrantyStartDate

Geben Sie das Startdatum der Garantie für das Gerät mithilfe eines Datetime-Objekts an.

Typ: DateTime
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False
-WhatIf

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

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

Allgemeine 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

System.Object

Der Parameter „InputObject“ akzeptiert ein PSObject, das die Eigenschaften des zu aktualisierenden nicht verwalteten Geräts enthält. Das Objekt muss eine Eigenschaft für die Geräte-ID enthalten und kann optional Eigenschaften für alle anderen Attribute enthalten, die aktualisiert werden können.

System.String

Die meisten Parameter dieses Cmdlets akzeptieren Zeichenfolgen als Eingabe, wenn der Parameter „InputObject“ nicht verwendet wird, z. B. „Name“, „Role“ und „Relation“.

System.DateTime

Parameter wie „PurchaseDate“, „WarrantyStartDate“ und „WarrantyEndDate“ akzeptieren Eingaben vom Typ „DateTime“, wenn der Parameter „InputObject“ nicht verwendet wird.

System.Decimal

Der Parameter „PurchaseAmount“ akzeptiert Dezimalwerte, wenn der Parameter „InputObject“ nicht verwendet wird.

System.Hashtable

Der Parameter „CustomFieldHashtable“ akzeptiert eine Hashtable-Eingabe, wenn der Parameter „InputObject“ nicht verwendet wird.

Ausgaben

System.Object

NinjaOne zeigt das neue nicht verwaltete Gerät nach einer erfolgreichen Synchronisierung an, die in der Regel innerhalb weniger Minuten erfolgt.

Weitere Ressourcen

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

FAQ

Nächste Schritte