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.
| Befehlszeilenname | Beschreibung |
|---|---|
| unmanaged-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. |
| unmanaged-get | Ruft 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-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 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.
| Feldname | Erforderlich (Ja/Nein) | Typ | Hinweise |
|---|---|---|---|
| Rolle | Ja | Zeichenkette | |
| Name | Ja | Zeichenkette | |
| Beziehung | Ja | Zeichenkette | Der Name der gerichteten Asset-Beziehung zwischen dem erstellenden und dem erstellten Gerät. |
| Garantiebeginn | Nein | Zeichenkette | Akzeptiert Datumsangaben im Format JJJJ-MM-TT. |
| Garantieenddatum | Nein | Zeichenfolge | Akzeptiert Datumsangaben im Format JJJJ-MM-TT. |
| Gerätebenutzer zuweisen | Nein | Boolescher Wert | Diese Option ist standardmäßig auf „false“ 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. |
| Ablaufdatum | 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-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 $UpdateDeviceWeitere Ressourcen
Weitere Informationen finden Sie unter NinjaOne IT Asset Management: Ressourcenkatalog, wo Sie alle zugehörigen Artikel einsehen können.