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 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: Informationen zu 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 seiner Erstellung anzupassen, 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 (Standard)

NinjaUnmanagedDevice [[-Name] <Zeichenfolge>] [-Role <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] [-Confirm][<CommonParameters>]

Pipeline

New-NinjaUnmanagedDevice [[-InputObject] <Object>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Beispiele

Beispiel 1: Erstellen anhand einzelner Eigenschaften

PS C:> New-NinjaUnmanagedDevice -Name „AEG-12345 auf Lukes Desktop“ -Role
„Monitors“ -Relation „Connected To“

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

Beispiel 2: Erstellen anhand eines Eingabeobjekts

$LukesMonitor = @{
assetId = "8675309"
assetSerialNumber = "9565035"
assetStatus = "In use"
endOfLifeDate = "2027-02-21"
expectedLifetime = "1 Jahr"
name = "AEG-12345 auf Lukes Desktop"
purchaseAmount = 100,00
purchaseDate = "2026-02-21"
relation = "Verbunden mit"
role = "Monitore"
warrantyEndDate = "2027-02-21"
warrantyStartDate = "2026-02-21"
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 "Connected To" -CustomFieldHashtable
$MyCustomFieldValues

Wenn Sie einzelne Eigenschaften verwenden und bestimmte benutzerdefinierte Feldwerte angeben 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
Parametersätze: IndividualProperties
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False

-AssetSerialNumber

Speichert die Seriennummern der nicht verwalteten Geräte.

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

-AssetStatus

Gibt 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: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False

-Bestätigen

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

-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
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. 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: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False

-Force

Wenn der Parameter „Confirm“ nicht angegeben ist, überschreibt der Parameter „Force“ die Einstellung „
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

-InputObject

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

Typ: Objekt
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: 0
Standardwert: Keine
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: Keine
Pipeline-Eingabe zulassen: Falsch
Platzhalterzeichen zulassen: Falsch

-PurchaseDate

Geben Sie 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

-Relation

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

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

-Role

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

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

-WarrantyEndDate

Geben Sie das Enddatum der Garantie des Geräts 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: 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 durch 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“, „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

Keine

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: