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-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

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-FeldesInterner Feldname
Asset-IDitamAssetId
Asset-StatusitamAssetStatus
AnschaffungsdatumitamAssetPurchaseDate
AnschaffungsbetragitamAssetPurchaseAmount
Erwartete LebensdaueritamAssetExpectedLifetime
Datum des BetriebsendesitamAssetEndOfLifeDate
Seriennummer des VermögenswertsitamAssetSerialNumber

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