Powershell: Get-NinjaUnmanagedDevice

Tema

En este artículo se explica cómo utilizar Get-NinjaUnmanagedDevice para recuperar los dispositivos no gestionados asociados al dispositivo actual.

Entorno

• NinjaOne
• Microsoft PowerShell

Descripción

El cmdlet Get-NinjaUnmanagedDevice recupera una lista de dispositivos no gestionados asociados
al dispositivo actual. Puede refinar los resultados especificando filtros como el nombre, la función, la relación o el ID. El cmdlet devuelve información detallada sobre cada dispositivo no gestionado, excluyendo los campos confidenciales.

Sintaxis

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

Ejemplos

Ejemplo 1: Recuperar todos los dispositivos no gestionados

PS C:> Get-NinjaUnmanagedDevice
assetId : 23458
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
id : 1308
name : Nvidia 5070
Get-NinjaUnmanagedDevice
1 / 5
Si no se especifica ningún nombre, función o relación, devuelve todos los dispositivos no gestionados que tengan una relación de activo
con el dispositivo actual.
Ejemplo 2: Filtrar la lista utilizando los parámetros opcionales
purchaseAmount : 0
purchaseDate :
relation : Parte de
role : GPU
warrantyEndDate :
warrantyStartDate :
assetId : 23457
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
id : 1307
name : LG Ultrawide
purchaseAmount : 0
purchaseDate :
relation : Conectado a
role : Monitores
warrantyEndDate :
warrantyStartDate :

Si no se especifica ningún nombre, función o relación, devuelve todos los dispositivos no gestionados que tengan una relación de activo
con el dispositivo actual.

Ejemplo 2: Filtrar la lista utilizando los parámetros opcionales

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 los dispositivos devueltos especificando el nombre, la función, la relación o el ID que estés buscando.

Parámetros

-Id
Especifica el ID único de un dispositivo no gestionado. Ten en cuenta que este es diferente del ID del activo
y no es visible en la interfaz de usuario web.

Tipo: Int32[]
Conjuntos de parámetros: Id
Alias:
Obligatorio: False
Posición: 0
Valor por defecto: Ninguno
Acepta entrada de canalización: True (ByValue)
Acepta caracteres comodín: False

-Nombre

Especifica el nombre exacto de los dispositivos no gestionados que deseas recuperar.

Tipo: String[]
Conjuntos de parámetros: Name
Alias:
Obligatorio: False
Posición: 0
Valor por defecto: Ninguno
Acepta entrada de canalización: True (ByValue)
Acepta caracteres comodín: False

-Relación
Filtra la lista recuperada según la relación de entidad de los dispositivos no gestionados.

Tipo: Cadena
Conjuntos de parámetros: (Todos)
Alias:
Obligatorio: Falso
Posición: Nombrada
Get-NinjaUnmanagedDevice
Valor predeterminado: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-Role

Recupera únicamente los dispositivos no gestionados que coincidan con la función de dispositivo no gestionado especificada.

Tipo: Cadena
Conjuntos de parámetros: (Todos)
Alias:
Obligatorio: Falso
Posición: Nombrado
Valor predeterminado: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

Parámetros comunes

Este cmdlet admite los siguientes parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -
InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -
Verbose, -WarningAction y -WarningVariable. Para obtener más información sobre los parámetros comunes, consulta el documento de Microsoft about_CommonParameters ( enlace externo).

Entradas

System.String[]

Puede canalizar una cadena que contenga el nombre de un dispositivo no gestionado a este cmdlet.
System.Int32[]
Puede canalizar un entero que contenga el ID del dispositivo no gestionado a este cmdlet.

Salidas

System.Object

Este cmdlet devuelve un objeto o una matriz de objetos que contienen los dispositivos no gestionados solicitados.

Recursos adicionales

Puede acceder a estos recursos para obtener más información sobre la creación de scripts personalizados y temas relacionados:

• NinjaOne Endpoint Management: Índice de comandos y artículos de PowerShell
• Gestión de activos de tecnología de la información (ITAM)
• NinjaOne ITAM: Primeros pasos
• NinjaOne ITAM: Trabajar con dispositivos no gestionados en NinjaOne
• NinjaOne ITAM: Crear un dispositivo no gestionado mediante la interfaz de línea de comandos (CLI)