Powershell: New-NinjaUnmanagedDevice

Thema

In diesem Artikel wird erläutert, wie Sie mit „New-NinjaUnmanagedDevice“ ein neues nicht verwaltetes Gerät mit den von Ihnen angegebenen Details erstellen.

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: Über Ausführungsrichtlinien ( Externer Link).

Umgebung

NinjaOne
Microsoft Powershell

Beschreibung

Das Cmdlet „New-NinjaUnmanagedDevice“ erstellt ein nicht verwaltetes Gerät und ordnet es einer angegebenen Asset-Beziehung zum aktuellen Gerät zu. Das neue nicht verwaltete Gerät wird automatisch derselben Organisation und demselben Standort zugewiesen wie das zugehörige verwaltete Gerät.

Darüber hinaus können Sie verschiedene optionale Felder angeben, um das Gerät bei der Erstellung zu personalisieren, beispielsweise das Start- und Enddatum der Garantie oder andere relevante Details. NinjaOne zeigt das neue nicht verwaltete Gerät nach einer erfolgreichen Synchronisierung an, die in der Regel innerhalb weniger Minuten erfolgt.

Syntax

Einzelne Eigenschaften (Standardwert)

NinjaUnmanagedDevice [[-Name] <ZEICHENFOLGE>] [-Rolle <ZEICHENFOLGE>] [-Relation<ZEICHENFOLGE>] [-AssetID <ZEICHENFOLGE>][-AssetSerialNumber <ZEICHENFOLGE>] [-AssetStatus <ZEICHENFOLGE>] [-EndOfLifeDate<DATUM/Uhrzeit>] [-ExpectedLifetime <ZEICHENKETTE>][-PurchaseAmount <DEZIMALZAHL>] [-PurchaseDate <DATUM und Uhrzeit>] [-WarrantyStartDate<DATUM und Uhrzeit>][-WarrantyEndDate <DATUM und Uhrzeit>] [-CustomFieldHashtable <HASHTABLE>] [-Force][-WhatIf] [-Bestätigen][<COMMONPARAMETERS>]

Pipeline

New-NinjaUnmanagedDevice [[-InputObject] <OBJECT>] [-Force] [-WhatIf] [-Bestätigen] [<COMMONPARAMETERS>]

Beispiele

Beispiel 1: Erstellen anhand einzelner Eigenschaften

PS C:> New-NinjaUnmanagedDevice -Name „AEG-12345 auf Lukes Desktop“ -Role
„Monitore“ -Relation „Verbunden mit“

Die Mindestangaben, die zum Erstellen eines nicht verwalteten Geräts erforderlich sind, sind dessen Name, die Gerätefunktion „
“ für nicht verwaltete Geräte sowie die Entitätsbeziehung.

Beispiel 2: Erstellen anhand eines Eingabeobjekts

$LukesMonitor = @{
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"
relation = "Verbunden mit"
Rolle = "Monitore"
warrantyEndDate = "21.02.2027"
warrantyStartDate = "21.02.2026"
customFieldValues = @{
exampleTextField = "Mein Textfeldwert"
}
}
PS C:> New-NinjaUnmanagedDevice -InputObject $LukesMonitor

Um zusätzliche Informationen mithilfe des Eingabeobjektformats anzugeben, formatieren Sie Ihr Objekt wie im obigen Beispiel unter „
“ gezeigt.

Beispiel 3: Verwendung der Hashtabelle für benutzerdefinierte Felder

$MyCustomFieldValues = @{
exampleTextField = "Mein benutzerdefinierter Textfeldwert"
}
PS C:> New-NinjaUnmanagedDevice -Name "AEG-12345 auf Lukes Desktop" -Role
"Monitors" -Relation "Verbunden mit" -CustomFieldHashtable
$MyCustomFieldValues

Wenn Sie einzelne Eigenschaften verwenden und bestimmte benutzerdefinierte Feldwerte festlegen möchten, können Sie den Parameter „
“ anstelle von „CustomFieldHashtable“ verwenden.

Parameter

-AssetID

Geben Sie eine Identifikationsnummer an, die Ihrem neuen Asset zugeordnet werden soll.

Typ: Zeichenfolge
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-AssetSerialNumber

Speichert die Seriennummern der nicht verwalteten Geräte.

Typ: Zeichenfolge
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-AssetStatus

Gibt den aktuellen Status des Assets an. Gültige Werte sind „Beschaffung“, „Provisionierung“, „
“, „Inventur“, „In Gebrauch“, „Wartung“, „Ausgemustert“ und „Archiviert“.

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

-Bestätigen

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

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

-ConfirmFieldHashtable

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
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: 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
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-ExpectedLifetime

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

Typ: Zeichenfolge
Parameter-Sätze: IndividualProperties
Aliase:
Zulässige Werte: 1 Jahr, 2 Jahre, 3 Jahre, 4 Jahre, 5 Jahre
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-Force

Wenn der Parameter „Confirm“ nicht angegeben ist, überschreibt der Parameter „Force“ die Einstellung „
ShouldProcess“ und erlaubt es dem Cmdlet, die Verarbeitung fortzufahren.

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

-InputObject

Geben Sie ein zu verarbeitendes Objekt an, anstatt einzelne Parameter zu verwenden.

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

-Name

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

Typ: Zeichenfolge
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: False
Position: 0
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: 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: Kein(e)
Pipeline-Eingabe akzeptieren: Falsch
Platzhalterzeichen akzeptieren: Falsch

-PurchaseDate

Gibt das Datum an, an dem das Gerät gekauft wurde, indem ein Datetime-Objekt verwendet wird.

Typ: DateTime
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: Falsch
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: Falsch
Platzhalterzeichen akzeptieren: Falsch

-Relation

Geben Sie die Beziehung des nicht verwalteten Geräts zum aktuellen Gerät an.

Typ: Zeichenfolge
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-Rolle

Geben Sie die Gerätefunktion des nicht verwalteten Geräts an.

Typ: Zeichenfolge
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-WarrantyEndDate

Geben Sie das Enddatum der Garantie mithilfe eines Datetime-Objekts an.

Typ: DateTime
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-WarrantyStartDate

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

Typ: DateTime
Parameter-Sätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
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: (ALLES)
Aliase: wi
Erforderlich: False
Position: Benannt
Standardwert: Kein(e)
Pipeline-Eingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

Gewöhnliche Parameter

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

Eingaben

System.Object

Dieses Cmdlet kann ein Objekt als Eingabe über die Pipeline oder nach Angabe des Parameters „InputObject“ akzeptieren.

System.String

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

System.DateTime

Parameter wie „PurchaseDate“, „WarrantyStartDate“ und „WarrantyEndDate“ akzeptieren „DateTime“-Eingaben, 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

Kein(e)

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

Zusätzliche Ressourcen

Weitere Informationen zur Bestandsverwaltung und zu benutzerdefinierten Skripten finden Sie in den folgenden Ressourcen: