Powershell: Get-NinjaUnmanagedDevice

Thema

In diesem Artikel wird erläutert, wie Sie mit „Get-NinjaUnmanagedDevice“ nicht verwaltete Geräte abrufen können, die mit dem aktuellen Gerät verknüpft sind.

Umgebung

• NinjaOne
• Microsoft PowerShell

Beschreibung

Das Cmdlet „Get-NinjaUnmanagedDevice“ ruft eine Liste der nicht verwalteten Geräte ab, die
mit dem aktuellen Gerät verknüpft sind. Sie können die Ergebnisse durch die Angabe von Filtern wie Name, Rolle, Beziehung oder ID verfeinern. Das Cmdlet gibt detaillierte Informationen zu jedem nicht verwalteten Gerät zurück, wobei sichere Felder ausgeschlossen werden.

Syntax

Get-NinjaUnmanagedDevice [[-Name] ] [-Role ] [-Relation ] [ ]

Beispiele

Beispiel 1: Alle nicht verwalteten Geräte abrufen

PS C:> Get-NinjaUnmanagedDevice
assetId : 23458
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
id : 1308
name : Nvidia 5070
Get-NinjaUnmanagedDevice
1 / 5
Wenn kein Name, keine Rolle und keine Beziehung angegeben werden, werden alle nicht verwalteten Geräte zurückgegeben, die eine Asset-Beziehung
zum aktuellen Gerät haben.
Beispiel 2: Filtern der Liste mithilfe der optionalen Parameter
purchaseAmount : 0
purchaseDate :
relation : Teil von
role : GPU
warrantyEndDate :
warrantyStartDate :
assetId : 23457
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
id : 1307
name : LG Ultrawide
purchaseAmount : 0
purchaseDate :
relation : Verbunden mit
role : Monitore
warrantyEndDate :
warrantyStartDate :

Wenn kein Name, keine Rolle oder keine Beziehung angegeben ist, werden alle nicht verwalteten Geräte zurückgegeben, die über eine Asset-Beziehung „
“ zum aktuellen Gerät verfügen.

Beispiel 2: Filtern der Liste mithilfe der optionalen Parameter

PS C:> Get-NinjaUnmanagedDevice -Relation "Teil von"
Asset-ID: 23458
Asset-Seriennummer:
Asset-Status:
End-of-Life-Datum:
erwartete Lebensdauer:
ID: 1308
name : Nvidia 5070
purchaseAmount : 0
purchaseDate :
relation : Part of
role : GPU
warrantyEndDate :
warrantyStartDate :

Filtern Sie die zurückgegebenen Geräte, indem Sie den Namen, die Rolle, die Beziehung oder die ID angeben, nach denen Sie suchen.

Parameter

-Id
Geben Sie die eindeutige ID eines nicht verwalteten Geräts an. Beachten Sie, dass sich diese von der Asset-ID
unterscheidet und in der Web-Benutzeroberfläche nicht sichtbar ist.

Typ: Int32[]
Parametersätze: Id
Aliase:
Erforderlich: False
Position: 0
Standardwert: Keine
Pipeline-Eingabe akzeptieren: True (ByValue)
Platzhalterzeichen akzeptieren: False

-Name

Geben Sie den genauen Namen der nicht verwalteten Geräte an, die Sie abrufen möchten.

Typ: String[]
Parametersätze: Name
Aliase:
Erforderlich: False
Position: 0
Standardwert: Keine
Pipeline-Eingabe akzeptieren: True (ByValue)
Platzhalterzeichen akzeptieren: False

-Relation
Filtert die abgerufene Liste nach der Entitätsbeziehung der nicht verwalteten Geräte.

Typ: Zeichenfolge
Parametersätze: (Alle)
Aliase:
Erforderlich: Falsch
Position: Benannt
Get-NinjaUnmanagedDevice
Standardwert: Keine
Pipeline-Eingabe akzeptieren: Falsch
Platzhalterzeichen akzeptieren: Falsch

-Role

Ruft nur nicht verwaltete Geräte ab, die der angegebenen Rolle für nicht verwaltete Geräte entsprechen.

Typ: Zeichenfolge
Parametersätze: (Alle)
Aliase:
Erforderlich: False
Position: Benannt
Standardwert: Keine
Pipeline-Eingabe zulassen: False
Platzhalterzeichen zulassen: False

Allgemeine Parameter

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -
InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -
Verbose, -WarningAction und -WarningVariable. Weitere Informationen zu allgemeinen Parametern finden Sie im Microsoft-Dokument „about_CommonParameters“ ( externer Link).

Eingaben

System.String[]

Sie können eine Zeichenfolge, die einen Namen eines nicht verwalteten Geräts enthält, an dieses Cmdlet weiterleiten.
System.Int32[]
Sie können eine Ganzzahl, die die ID eines nicht verwalteten Geräts enthält, an dieses Cmdlet weiterleiten.

Ausgaben

System.Object

Dieses Cmdlet gibt ein Objekt oder ein Array von Objekten aus, das die von Ihnen angeforderten nicht verwalteten Geräte enthält.

Weitere Ressourcen

Weitere Informationen zu benutzerdefinierten Skripten und verwandten Themen finden Sie in den folgenden Ressourcen:

• NinjaOne Endpoint Management: Index der PowerShell-Befehle und Artikel
• Informationstechnologie-Asset-Management (ITAM)
• NinjaOne ITAM: Erste Schritte
• NinjaOne ITAM: Arbeiten mit nicht verwalteten Geräten in NinjaOne
• NinjaOne ITAM: Ein nicht verwaltetes Gerät über die Befehlszeilenschnittstelle (CLI) erstellen