Sei già un cliente NinjaOne? Effettua il login per visualizzare le altre guide e gli ultimi aggiornamenti.

Powershell: Get-NinjaUnmanagedDevice

Argomento

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

Se si utilizza il modulo NinjaOne per PowerShell al di fuori di uno script di automazione, potrebbe essere necessario modificare la politica di esecuzione di PowerShell. Per altre informazioni sulle politiche di esecuzione, consultare la documentazione di Microsoft: Informazioni sulle politiche di esecuzione ( link esterno).

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, esclusi i campi protetti.

I dispositivi non gestiti devono appartenere alla stessa organizzazione e alla stessa posizione del dispositivo gestito a cui sono associati
.

Sintassi

Get-NinjaUnmanagedDevice [[-Nome]] [-Ruolo] [-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 facoltativi
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 : Connesso a
role : Monitoraggi
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 risorsa
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 da pipeline: True (ByValue)
Accetta caratteri jolly: False
-Relation
Filtra l'elenco recuperato in base alla relazione tra le entità dei Dispositivi non gestiti.

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

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 altre informazioni sui parametri comuni, consultare il documento Microsoft about_CommonParameters ( link esterno).

Input

Sistema.String[]

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

Uscite

Il sistema.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 altre informazioni sulla creazione di script personalizzati e argomenti correlati:

Domande frequenti

Passi successivi