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

NinjaOne IT-Asset-Management: Erstellen eines nicht verwalteten Geräts über die Befehlszeilenschnittstelle (CLI)

Thema

In diesem Artikel wird erläutert, wie Sie mit Hilfe von Befehlszeilentools (CLI) ein nicht verwaltetes Gerät in NinjaOne erstellen können. 

Umgebung

NinjaOne Endpoint Management

Beschreibung

Wenn Sie nicht verwaltete Geräte über die CLI erstellen, können Sie Elemente wie Monitore, USB-Drucker und andere Peripheriegeräte erkennen und die Beziehung dieser Elemente 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 in die Konsole einträgt, sofern dies möglich ist.

Wenn Sie den NinjaOne RMM-Agenten auf dem Gerät installieren, sendet NinjaOne die System- und BIOS-Seriennummern an die anfängliche Nutzlast, um die Datenzuordnung zu optimieren.

Index

Wählen Sie eine Kategorie aus, um mehr zu erfahren:

Neue Befehlszeilenoptionen

Wir haben neue Befehlszeilen erstellt und Optionen zu bestehenden Befehlszeilen hinzugefügt, um diesen Prozess zu vereinfachen. 

BefehlszeilennameBeschreibung
unmanaged-newErstellen 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.
unmanaged-getRuft die Werte der nicht verwalteten Geräte ab, die mit dem verwalteten Gerät verbunden sind, einschließlich der ID-Nummern für jedes Asset (mit Ausnahme sicherer Felder). Das nicht verwaltete Gerät muss derselben Organisation und demselben Standort angehören wie das zugehörige verwaltete Gerät.
unmanaged-setAktualisieren Sie die Werte für vorhandene nicht verwaltete Geräte anhand der Geräte-ID. Diese Befehlszeile funktioniert nur, wenn das nicht verwaltete Gerät mit einem vorhandenen verwalteten Gerät verbunden ist und derselben Organisation und demselben Standort angehört.
user-setLegen Sie den derzeit zugewiesenen Benutzer des Geräts fest. Sie können eine E-Mail-Adresse als Parameter verwenden, und NinjaOne sucht nach Endbenutzern, Technikern und Kontakten. Wenn ein Konto oder Kontakt auf eine Organisation beschränkt ist, gleicht NinjaOne nur Geräte ab, die zur gleichen Organisation wie der Benutzer gehören. Techniker müssen über die Berechtigung zum Zugriff auf das Gerät verfügen. 

In der folgenden Tabelle sind die Felder aufgeführt, die Sie mit der Befehlszeile „unmanaged-new“ verwenden können, um nicht verwaltete Geräte zu definieren.

FeldnameErforderlich (Ja/Nein)TypAnmerkungen
RolleJaZeichenfolge
NameJaZeichenfolge
BeziehungJaZeichenfolgeDer Name der gerichteten Asset-Beziehung zwischen dem erstellenden und dem erstellten Gerät.
GarantiebeginnNeinZeichenAkzeptiert Datumsangaben im Format JJJJ-MM-TT.
GarantieendeNeinZeichenfolgeAkzeptiert Datumsangaben im Format JJJJ-MM-TT.
Gerätebenutzer zuweisenNeinBooleschDiese Option ist standardmäßig auf „false” gesetzt.
Asset-IDNeinZeichenfolge
Asset-StatusNeinZeichenfolge
KaufdatumNeinZeichenAkzeptiert Datumsangaben im Format JJJJ-MM-TT.
KaufbetragNeinFloat
Erwartete LebensdauerNeinZeichenAkzeptiert 1, 2, 3, 4 oder 5 Jahre.
Ende der LebensdauerNeinZeichenfolgeAkzeptiert Daten im Format JJJJ-MM-TT.
Seriennummer des VermögenswertsNeinZeichenfolge
Benutzerdefinierte FeldwerteNeinMehrWie bei der Erstellung definiert.

Beispiel:

.ninjarmm-clie.exe unmanaged-new '{ "assignToDeviceUser":true, "assetId": "asset-001", 
"assetSerialNumber": "asset-serial-001", "assetStatus": "in use", "customFieldValues": 
{"exampleCustomFieldName": "Custom Field Value", "typeipaddress": "255.255.255.255"},
„endOfLifeDate”: „2025-12-31”, „expectedLifetime”: „5 years”, „name”: „Test Device with 
CF”, „purchaseAmount”: 1000, „purchaseDate”: „2020-01-01”, „relation”: „related to”, 
„role”: „Another Role”, „warrantyEndDate”: „2023-12-31”, „warrantyStartDate”: „2021-01-01”}'

Verwendung von PowerShell-Befehlen

NinjaOne unterstützt PowerShell-Befehle für Folgendes:

  • New-NinjaUnmanagedDevice
  • Get-NinjaUnmanagedDevice
  • Set-NinjaUnmanagedDevice
  • Set-NinjaUser

Beispiel: 

$DiscoveredMonitor = @{
   role               = "Monitor"
   name               = "AEG-12345 auf Lukes Desktop"
   relation           = "Connected To"
   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 'Connected To'
$UpdateDevice = $Devices[0]
$UpdateDevice.monitorResolution = '5120 x 1440'
$Null = Set-NinjaUnmanagedDevice $UpdateDevice

Weitere Ressourcen

Alle zugehörigen Artikel finden Sie unter NinjaOne IT Asset Management: Ressourcen-Katalog

FAQ

Nächste Schritte