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 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 Initial Payload, 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 (ohne sichere Felder). Das nicht verwaltete Gerät muss derselben Organisation und demselben Standort angehören wie das zugehörige verwaltete Gerät.
unmanaged-setAktualisieren 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-setLegen Sie den aktuell zugewiesenen Benutzer des Geräts fest. Sie können eine E-Mail-Adresse als Parameter verwenden, und NinjaOne durchsucht 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 Zugriff auf das Gerät verfügen. 

Die folgende Tabelle listet die Felder auf, die Sie mit der Befehlszeile „unmanaged-new“ verwenden können, um nicht verwaltete Geräte zu definieren.

FeldnameErforderlich (Ja/Nein)TypHinweise
RolleJaZeichenkette
NameJaZeichenkette
BeziehungJaZeichenketteDer Name der gerichteten Asset-Beziehung zwischen dem erstellenden und dem erstellten Gerät.
GarantiebeginnNeinZeichenketteAkzeptiert Datumsangaben im Format JJJJ-MM-TT.
GarantieenddatumNeinZeichenfolgeAkzeptiert Datumsangaben im Format JJJJ-MM-TT.
Gerätebenutzer zuweisenNeinBoolescher WertDiese Option ist standardmäßig auf „false“ gesetzt.
Asset-IDNeinZeichenkette
Asset-StatusNeinZeichenkette
KaufdatumNeinZeichenketteAkzeptiert Datumsangaben im Format JJJJ-MM-TT.
KaufbetragNeinFloat
Erwartete LebensdauerNeinZeichenketteAkzeptiert 1, 2, 3, 4 oder 5 Jahre.
AblaufdatumNeinZeichenketteAkzeptiert Datumsangaben im Format JJJJ-MM-TT.
Seriennummer des AssetsNeinZeichenkette
Werte für benutzerdefinierte FelderNeinMehrereWie 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 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:

  • New-NinjaUnmanagedDevice
  • Get-NinjaUnmanagedDevice
  • Set-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 'Connected To'
$UpdateDevice = $Devices[0]
$UpdateDevice.monitorResolution = '5120 x 1440'
$Null = Set-NinjaUnmanagedDevice $UpdateDevice

Weitere Ressourcen

Weitere Informationen finden Sie unter NinjaOne IT Asset Management: Ressourcenkatalog, wo Sie alle zugehörigen Artikel einsehen können. 

FAQ

Nächste Schritte