Thema
In diesem Artikel wird erläutert, wie Sie in NinjaOne mithilfe von CLI-Tools (Command-Line Interface) ein nicht verwaltetes Gerät erstellen.
Umgebung
NinjaOne IT-Asset-Management (ITAM)
Beschreibung
Beim Erstellen nicht verwalteter Geräte über die CLI können Sie Geräte wie Monitore, USB-Drucker und andere Peripheriegeräte erkennen und die Beziehung dieser Geräte zu verwalteten Geräten in NinjaOne definieren. Darüber hinaus können Sie das nicht verwaltete Gerät über die CLI einem Benutzer zuweisen, woraufhin NinjaOne die Daten gegebenenfalls in der Konsole einträgt.
Wenn Sie den NinjaOne-RMM-Agenten auf dem Gerät installieren, sendet NinjaOne die System- und BIOS-Seriennummern an die anfängliche Payload, um die Datenzuordnung zu optimieren.
Index
Auswählen Sie eine Kategorie, um mehr zu erfahren:
Neue Befehlszeilenoptionen
Wir haben neue Befehlszeilen erstellt und Optionen zu bestehenden Befehlszeilen hinzugefügt, um diesen Vorgang zu vereinfachen.
| Befehlszeilenname | Beschreibung |
|---|---|
| Nicht verwaltet-new | Erstellen Sie ein nicht verwaltetes Gerät und übergeben Sie ein JSON-Objekt, um es zu definieren. Wenn Sie ein nicht verwaltetes Gerät über die CLI erstellen, wird das Gerät automatisch derselben Organisation und demselben Standort zugewiesen wie das zugehörige verwaltete Gerät. |
| Nicht verwaltetes Get | Ruft die Werte der nicht verwalteten Geräte ab, die mit dem verwalteten Gerät verknüpft sind, einschließlich der ID-Nummern für jedes Asset (ohne sichere Felder). Das nicht verwaltete Gerät muss derselben Organisation und demselben Standort angehören wie das zugehörige verwaltete Gerät. |
| unmanaged-set | Aktualisieren Sie Werte für vorhandene nicht verwaltete Geräte anhand der Geräte-ID. Dieser Befehl funktioniert nur, wenn das nicht verwaltete Gerät mit einem vorhandenen verwalteten Gerät verknüpft ist und derselben Organisation und demselben Standort angehört. |
| user-set | Legen Sie den aktuell dem Gerät zugewiesenen Benutzer fest. Sie können eine E-Mail-Adresse als Parameter verwenden; NinjaOne durchsucht dann Endbenutzer, Techniker und Kontakte. Wenn ein Konto oder Kontakt auf eine Organisation beschränkt ist, gleicht NinjaOne nur Geräte ab, die derselben Organisation wie der Benutzer angehören. Techniker müssen über die Berechtigung zum Zugang zum Gerät verfügen. |
In der folgenden Tabelle sind die Felder aufgeführt, die Sie mit der Befehlszeile „unmanaged-new“ zur Definition nicht verwalteter Geräte verwenden können.
| Feldname | Erforderlich (Ja/Nein) | Typ | Anmerkungen |
|---|---|---|---|
| Rolle | Ja | Zeichenkette | |
| Name | Ja | Zeichenkette | |
| Beziehung | Ja | Zeichenkette | Der Name der gerichteten Asset-Beziehung zwischen dem erstellenden und dem erstellten Gerät. |
| Startdatum der Garantie | Nein | Zeichenkette | Akzeptiert Datumsangaben im Format JJJJ-MM-TT. |
| Enddatum der Garantie | Nein | Zeichenfolge | Akzeptiert Datumsangaben im Format JJJJ-MM-TT. |
| Zuweisen an Gerät | Nein | Boolescher Wert | Diese Option ist als Standardwert auf „Falsch“ gesetzt. |
| Asset-ID | Nein | Zeichenkette | |
| Asset-Status | Nein | Zeichenkette | |
| Kaufdatum | Nein | Zeichenkette | Akzeptiert Datumsangaben im Format JJJJ-MM-TT. |
| Kaufbetrag | Nein | Float | |
| Erwartete Lebensdauer | Nein | Zeichenkette | Akzeptiert 1, 2, 3, 4 oder 5 Jahre. |
| Datum des Betriebsendes | Nein | Zeichenkette | Akzeptiert Datumsangaben im Format JJJJ-MM-TT. |
| Seriennummer des Assets | Nein | Zeichenkette | |
| Werte für benutzerdefinierte Felder | Nein | Mehrere | Wie bei der Erstellung definiert. |
Beispiel:
.ninjarmm-cli.exe unmanaged-new '{ "assignToDeviceUser":true, "assetId": "asset-001",
"assetSerialNumber": "asset-serial-001", "assetStatus": "In Gebrauch", "customFieldValues":
{"exampleCustomFieldName": "Feldwert", "typeipaddress": "255.255.255.255"},
"endOfLifeDate": "2025-12-31", "expectedLifetime": "5 Jahre", "name": "Testgerät mit
CF", "purchaseAmount": 1000, "purchaseDate": "2020-01-01", "relation": "verknüpft mit",
"role": "Eine andere Rolle", "warrantyEndDate": "31.12.2023", "warrantyStartDate": "01.01.2021"}'Verwendung von Powershell-Befehlen
NinjaOne unterstützt Powershell-Befehle für Folgendes:
- Neu-NinjaUnmanagedDevice
- Get-NinjaUnmanagedDevice
- Einstellen von NinjaUnmanagedDevice
- Set-NinjaUser
Beispiel:
$DiscoveredMonitor = @{
role = "Monitor"
name = "AEG-12345 auf Lukes Desktop"
relation = "Verbunden mit"
assignToDeviceUser = $true
assetId = "123456"
assetSerialNumber = "123456"
customFieldHashMap = @{
monitorResolution = "1920 x 1080"
monitorManufacturer = "AEG"
monitorModel = "12345"
}
}
$Null = New-NinjaUnmanagedDevice $DiscoveredMonitor
$Devices = Get-NinjaUnmanagedDevice -Role 'Monitor' -Relation 'Verbunden'
$UpdateDevice = $Devices[0]
$UpdateDevice.monitorResolution = '5120 x 1440'
$Null = Set-NinjaUnmanagedDevice $UpdateDeviceZusätzliche Ressourcen
Alle ITAM-Artikel finden Sie unter „NinjaOne IT Asset Management: Ressourcenkatalog “.