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 [[-Nombre]] [-Función] [-Relación] []

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, rol 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 usando los parámetros opcionales

PS C:> Get-NinjaUnmanagedDevice -Relation "Parte de"
assetId : 23458
assetSerialNumber :
assetStatus :
endOfLifeDate :
expectedLifetime :
ID : 1308
name : Nvidia 5070
purchaseAmount : 0
purchaseDate :
relation : Part of
función : 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:
Requerido: False
Posición: 0
Valor predeterminado: 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:
Requerido: 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 por la relación de entidad de los dispositivos no gestionados.

Tipo: Cadena
Conjuntos de parámetros: (Todo)
Alias:
Requerido: Falso
Posición: Nombrada
Get-NinjaUnmanagedDevice
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-Función

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

Sistema.String[]

Puede pasar mediante una canalización una cadena que contenga el nombre del dispositivo no gestionado a este cmdlet.
System.Int32[]
Puede pasar mediante una canalización un entero que contenga el ID del dispositivo no gestionado a este cmdlet.

Salidas

Sistema.Object

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

Recursos adicionales

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

• NinjaOne Gestión de endpoints: Í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)