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

NinjaOne ITAM: Verwendung von API-Skripten für den Zugriff auf zentrale Asset-Felder

Thema

In diesem Artikel wird erläutert, wie Sie bestimmte Asset-Felder mithilfe der Befehlszeile (CLI) und der Anwendungsprogrammierschnittstelle (API) von NinjaOne aktualisieren können. 

Umgebung

  • NinjaOne IT-Asset-Management (ITAM)
  • Öffentliche API von NinjaOne
  • NinjaOne Endpunkt-Management

Beschreibung

Über die API können Sie mithilfe der Endpunkte für benutzerdefinierte Felder und deren interne Namen auf zentrale Asset-Felder zugreifen. Darüber hinaus können Sie die NinjaOne-CLI verwenden, um die Asset-ID und die Asset-Seriennummer abzurufen und zu aktualisieren. 

Auswählen Sie eine Kategorie, um mehr zu erfahren: 

Kernfelder von Assets mit der CLI aktualisieren

Um über die CLI mit Kernfeldern von Assets zu interagieren, müssen Sie die folgenden internen Feldnamen verwenden: 

Asset-Feldname Interner Feldname
Asset-ID itamAssetID
Seriennummer des Assets itamAssetSerialNumber

Der folgende Code-Block zeigt 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

Felder von Assets mit der API aktualisieren

Sie können die öffentliche API von NinjaOne nutzen, um über die Endpunkte für Benutzerdefinierte Felder und deren interne Namen mit den Kernfeldern von Assets zu interagieren: 

Feldname des Asset-Feldes Interner Feldname
Asset-ID itamAssetId
Asset-Status itamAssetStatus
Anschaffungsdatum itamAssetPurchaseDate
Anschaffungsbetrag itamAssetPurchaseAmount
Erwartete Lebensdauer itamAssetExpectedLifetime
Datum des Betriebsendes itamAssetEndOfLifeDate
Seriennummer des Vermögenswerts itamAssetSerialNumber

Feldwerte abrufen

Der folgende Code-Block zeigt 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
$Felder | Auswählen itamAssetId, itamAssetStatus, itamAssetPurchaseDate, itamAssetPurchaseAmount, itamAssetExpectedLifetime, itamAssetEndOfLifeDate, itamAssetSerialNumber
itamAssetStatus           : In Gebrauch
itamAssetPurchaseDate     : 1759316400000
itamAssetPurchaseAmount   : 1000
itamAssetExpectedLifetime : 2 Jahre
itamAssetEndOfLifeDate    : 1822388400000
itamAssetSerialNumber     : UpdateSerialNumber

Feldwerte einstellen

Datum-Felder erfordern einen UTC-Zeitstempel in Millisekunden. Die erwartete Lebensdauer wird in Kleinbuchstaben eingegeben.

Der folgende Code-Block enthält ein Beispiel dafür, wie Sie Feldwerte einstellen können: 

$AssetFields = @{
    itamAssetId = 'UpdatedViaAPIID'
    itamAssetStatus = 'Provisionierung'
    itamAssetPurchaseDate = 1759316400000
    itamAssetPurchaseAmount = '1500'
    itamAssetExpectedLifetime = '3 Jahre'
    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-Json

Zusätzliche Ressourcen

Weitere Informationen zur Anlagenverwaltung in NinjaOne finden Sie in den folgenden Ressourcen:

FAQ

Nächste Schritte