Thema
Dieser Artikel erklärt, wie man bestimmte Asset-Felder über die Befehlszeilenschnittstelle (CLI) und die NinjaOne Programmierschnittstelle (API) aktualisiert.
Umgebung
- NinjaOne IT Vermögensverwaltung (ITAM)
- NinjaOne Öffentliche API
- NinjaOne Endpunkt-Verwaltung
Beschreibung
Sie können über die API mit zentralen Asset-Feldern interagieren, indem Sie die benutzerdefinierten Feldendpunkte und ihre internen Namen verwenden. Außerdem können Sie mit NinjaOne CLI die Asset-ID und die Asset-Seriennummer abrufen und aktualisieren.
Wählen Sie eine Kategorie, um mehr zu erfahren:
- Aktualisieren von Core Asset-Feldern mit CLI
- Aktualisieren von Core Asset-Feldern mit API
- Zusätzliche Ressourcen
Aktualisieren von Core Asset-Feldern mit CLI
Um mit Core-Asset-Feldern über die CLI zu interagieren, müssen Sie die folgenden internen Feldnamen verwenden:
| Asset Feldname | Interner Feldname |
|---|---|
| Asset-ID | itamAssetID |
| Seriennummer des Assets | itamAssetSerialNumber |
Der folgende Codeblock ist ein Beispiel dafür, wie Sie mit den Feldern interagieren können:
ninja-Property-get itamAssetID
ExampleAsset-001
ninja-Property-get itamAssetSerialNumber
1234567890
ninja-Property-set itamAssetID UpdatedAssetID
ninja-Property-set itamAssetSerialNumber UpdatedSerialNumber
Aktualisieren von Core Asset-Feldern mit API
Sie können die öffentliche API von NinjaOne verwenden, um mit den Kernfeldern von Assets zu interagieren, indem Sie die benutzerdefinierten Feldendpunkte und ihre internen Namen verwenden:
| Asset Feldname | Interner Feldname |
|---|---|
| Asset-ID | itamAssetId |
| Vermögensstatus | itamAssetStatus |
| Kaufdatum | itamAssetPurchaseDate |
| Kaufbetrag | itamAssetPurchaseAmount |
| Erwartete Lebenserwartung | itamAssetExpectedLifetime |
| Datum des Endes der Lebensdauer | itamAssetEndOfLifeDate |
| Seriennummer der Anlage | itamAssetSerialNumber |
Feldwerte abrufen
Der folgende Befehlscodeblock ist ein Beispiel dafür, wie Sie Feldwerte abrufen können:
$Fields = (Invoke-WebRequest -uri "$($NinjaURL)/v2/device/21/custom-fields" -Method Get -Headers $AuthHeader -ContentType 'application/json').Content | ConvertFrom-Json$Fields | Select itamAssetId, itamAssetStatus, itamAssetPurchaseDate, itamAssetPurchaseAmount, itamAssetExpectedLifetime, itamAssetEndOfLifeDate, itamAssetSerialNumberitamAssetId : UpdateAssetIDitamAssetStatus : In useitamAssetPurchaseDate : 1759316400000itamAssetPurchaseAmount : 1000itamAssetExpectedLifetime : 2 yearsitamAssetEndOfLifeDate : 1822388400000itamAssetSerialNumber : UpdateSerialNumber
Feldwerte festlegen
Datumsfelder erfordern einen UTC-Zeitstempel in Millisekunden. Die erwartete Lebensdauer muss in Kleinbuchstaben angegeben werden.
Der folgende Befehlscodeblock ist ein Beispiel dafür, wie Sie Feldwerte festlegen können:
$AssetFields = @{ itamAssetId = 'UpdatedViaAPIID' itamAssetStatus = 'Provisioning' itamAssetPurchaseDate = 1759316400000 itamAssetPurchaseAmount = '1500' itamAssetExpectedLifetime = '3 years' itamAssetEndOfLifeDate = 1822388400000 itamAssetSerialNumber = 'UpdatedViaAPISerial'} | ConvertTo-Json$Fields = (Invoke-WebRequest -uri "$($NinjaURL)/v2/device/21/custom-fields" -Method PATCH -Headers $AuthHeader -Body $AssetFields -ContentType 'application/json').Content | ConvertFrom-JsonZusätzliche Ressourcen
In den folgenden Ressourcen erfahren Sie mehr über die Vermögensverwaltung in NinjaOne: