Powershell: Get-NinjaUnmanagedDevice

Argomento

Questo articolo spiega come utilizzare Get-NinjaUnmanagedDevice per recuperare i dispositivi non gestiti associati al dispositivo corrente.

Ambiente

• NinjaOne
• Microsoft PowerShell

Descrizione

Il cmdlet Get-NinjaUnmanagedDevice recupera un elenco di dispositivi non gestiti associati
al dispositivo corrente. È possibile affinare i risultati specificando filtri quali nome, ruolo, relazione o ID. Il cmdlet restituisce informazioni dettagliate su ciascun dispositivo non gestito, escludendo i campi protetti.

Sintassi

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

Esempi

Esempio 1: recuperare tutti i dispositivi non gestiti

PS C:> Get-NinjaUnmanagedDevice
assetId : 23458
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
id : 1308
name : Nvidia 5070
Get-NinjaUnmanagedDevice
1 / 5
Se non vengono specificati nome, ruolo o relazione, restituisce tutti i dispositivi non gestiti con una relazione di asset
rispetto al dispositivo corrente.
Esempio 2: Filtrare l’elenco utilizzando i parametri opzionali
purchaseAmount : 0
purchaseDate :
relation : Parte di
role : GPU
warrantyEndDate :
warrantyStartDate :
assetId : 23457
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
id : 1307
name : LG Ultrawide
purchaseAmount : 0
purchaseDate :
relation : Collegato a
role : Monitor
warrantyEndDate :
warrantyStartDate :

Se non vengono specificati nome, ruolo o relazione, vengono restituiti tutti i dispositivi non gestiti con una relazione di asset
al dispositivo corrente.

Esempio 2: Filtrare l’elenco utilizzando i parametri opzionali

PS C:> Get-NinjaUnmanagedDevice -Relation "Part of"
assetId : 23458
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
id : 1308
name : Nvidia 5070
purchaseAmount : 0
purchaseDate :
relation : Part of
role : GPU
warrantyEndDate :
warrantyStartDate :

Filtra i dispositivi restituiti specificando il nome, il ruolo, la relazione o l’ID che stai cercando.

Parametri

-Id
Specifica l'ID univoco di un dispositivo non gestito. Si noti che questo è diverso dall'ID del bene
e non è visibile nell'interfaccia utente web.

Tipo: Int32[]
Set di parametri: Id
Alias:
Obbligatorio: False
Posizione: 0
Valore predefinito: Nessuno
Accetta input dalla pipeline: True (ByValue)
Accetta caratteri jolly: False

-Nome

Specificare il nome esatto dei dispositivi non gestiti che si desidera recuperare.

Tipo: String[]
Set di parametri: Name
Alias:
Obbligatorio: False
Posizione: 0
Valore predefinito: Nessuno
Accetta input dalla pipeline: True (ByValue)
Accetta caratteri jolly: False

-Relation
Filtra l'elenco recuperato in base alla relazione tra le entità dei dispositivi non gestiti.

Tipo: String
Set di parametri: (Tutti)
Alias:
Obbligatorio: False
Posizione: Denominata
Get-NinjaUnmanagedDevice
Valore predefinito: Nessuno
Accetta input dalla pipeline: False
Accetta caratteri jolly: False

-Role

Recupera solo i dispositivi non gestiti che corrispondono al ruolo specificato per i dispositivi non gestiti.

Tipo: Stringa
Set di parametri: (Tutti)
Alias:
Obbligatorio: Falso
Posizione: Denominato
Valore predefinito: Nessuno
Accetta input dalla pipeline: Falso
Accetta caratteri jolly: Falso

Parametri comuni

Questo cmdlet supporta i seguenti parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -
InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -
Verbose, -WarningAction e -WarningVariable. Per ulteriori informazioni sui parametri comuni, consultare il documento Microsoft about_CommonParameters ( link esterno).

Input

System.String[]

È possibile convogliare tramite pipe una stringa contenente il nome di un dispositivo non gestito a questo cmdlet.
System.Int32[]
È possibile convogliare tramite pipe un numero intero contenente l'ID del dispositivo non gestito a questo cmdlet.

Uscite

System.Object

Questo cmdlet restituisce un oggetto o un array di oggetti contenente i dispositivi non gestiti richiesti.

Risorse aggiuntive

È possibile accedere a queste risorse per ulteriori informazioni sulla creazione di script personalizzati e argomenti correlati:

• NinjaOne Endpoint Management: Indice dei comandi e degli articoli di PowerShell
• Gestione delle risorse informatiche (ITAM)
• NinjaOne ITAM: Guida introduttiva
• NinjaOne ITAM: Utilizzo dei dispositivi non gestiti in NinjaOne
• NinjaOne ITAM: Creazione di un dispositivo non gestito tramite l'interfaccia della riga di comando (CLI)