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 Befehlszeilenschnittstelle (CLI) und der Anwendungsprogrammierschnittstelle (API) von NinjaOne aktualisieren können. 

Umgebung

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

Beschreibung

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

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

Kernfelder von Assets mit der CLI aktualisieren

Um über die CLI mit Kern-Asset-Feldern zu interagieren, müssen Sie die folgenden internen Feldnamen verwenden: 

Asset-FeldnameInterner Feldname
Asset-IDitamAssetID
Seriennummer des AssetsitamAssetSerialNumber

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

Kernfelder von Assets mit der API aktualisieren

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

Asset-FeldnameInterner Feldname
Asset-IDitamAssetId
Asset-StatusitamAssetStatus
KaufdatumitamAssetPurchaseDate
KaufbetragitamAssetPurchaseAmount
Erwartete LebensdaueritamAssetExpectedLifetime
Datum des BetriebsendesitamAssetEndOfLifeDate
Seriennummer des VermögenswertsitamAssetSerialNumber

Feldwerte abrufen

Der folgende Befehlscode-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
$Fields | Select itamAssetId, itamAssetStatus, itamAssetPurchaseDate, itamAssetPurchaseAmount, itamAssetExpectedLifetime, itamAssetEndOfLifeDate, itamAssetSerialNumber

itamAssetId               : UpdateAssetID
itamAssetStatus           : In use
itamAssetPurchaseDate     : 1759316400000
itamAssetPurchaseAmount   : 1000
itamAssetExpectedLifetime : 2 years
itamAssetEndOfLifeDate    : 1822388400000
itamAssetSerialNumber     : UpdateSerialNumber

Feldwerte festlegen

Datumsfelder erfordern einen UTC-Zeitstempel in Millisekunden. Die erwartete Lebensdauer muss in Kleinbuchstaben eingegeben werden.

Der folgende Befehlscode-Block enthält 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-Json

Weitere Ressourcen

Weitere Informationen zum Asset-Management in NinjaOne finden Sie in den folgenden Ressourcen:

FAQ

Nächste Schritte