Powershell: Set-NinjaUnmanagedDevice

Tema

En este artículo se explica cómo utilizar Set-NinjaUnmanagedDevice para actualizar los atributos de un dispositivo no gestionado específico.

Entorno

• NinjaOne
• Microsoft PowerShell

Descripción

El cmdlet Set-NinjaUnmanagedDevice actualiza los atributos de un dispositivo no gestionado especificado. Puedes actualizar atributos como la información del activo, los detalles de la compra, las fechas de garantía y los campos personalizados. Los cambios en los dispositivos no gestionados se aplican tras la siguiente sincronización correcta con la plataforma NinjaOne, lo que suele ocurrir en unos minutos.

Sintaxis

Set-NinjaUnmanagedDevice [-AssetID <Cadena>] [-AssetSerialNumber <Cadena>][-AssetStatus <Cadena>][-EndOfLifeDate <FechaHora>] [-ExpectedLifetime <Cadena>] [[-ID] <Int32>] [-Name <Cadena>][-PurchaseAmount <Decimal>] [-PurchaseDate <Fecha y hora>] [-WarrantyStartDate<Fecha y hora>][-WarrantyEndDate <Fecha y hora>] [-CustomFieldHashtable <Tabla hash>] [-Force][-WhatIf] [-Confirm][<Parámetros comunes>]

Ejemplos

Ejemplo 1: Modificar utilizando propiedades individuales

PS C:> Set-NinjaUnmanagedDevice -Id 1314 -PurchaseAmount 100.00

El importe de compra del dispositivo no gestionado con ID 1314 se actualiza a 100,00 $.

Ejemplo 2: Modificar mediante un objeto de entrada

$LukesMonitor = @{
id = 1314
assetId = "8675309"
assetSerialNumber = "9565035"
assetStatus = "En uso"
endOfLifeDate = "2027-02-21"
expectedLifetime = "1 año"
name = "AEG-12345 en el ordenador de Lukes"
purchaseAmount = 100,00
purchaseDate = "2026-02-21"
warrantyEndDate = "2027-02-21"
fechaInicioGarantía = "21/02/2026"
valoresCamposPersonalizados = @{
campoTextoEjemplo = "El valor de mi campo de texto"
}
}
PS C:> $LukesMonitor | Set-NinjaUnmanagedDevice

Los atributos del dispositivo no gestionado con ID 1314 se actualizan en función de los valores proporcionados en el objeto de entrada.

Parámetros

-AssetID

Especifica un número de identificación para asociarlo al dispositivo. No es lo mismo que el ID del dispositivo en NinjaOne, pero puede utilizarse para realizar un seguimiento de la información del activo.

Tipo: Cadena
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: Falso
Posición: Nombrado
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-AssetSerialNumber

Especifica el número de serie del dispositivo que se va a asociar al mismo.

Tipo: Cadena
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: Falso
Posición: Nombrado
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-AssetStatus

Especifica el estado actual del activo. Los valores válidos son «Adquisición», «Aprovisionamiento», «Inventario», «En uso», «Mantenimiento», «Retirado» y «Archivado».

Tipo: Cadena
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: Falso
Posición: Nombrado
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

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

-CustomFieldHashtable

Establece los campos personalizados del dispositivo utilizando una tabla hash. Utiliza el nombre del campo personalizado como clave y su valor correspondiente como valor.

Tipo: Tabla hash
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: Falso
Posición: Nombrado
Valor predeterminado: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-EndOfLifeDate

Especifica la fecha en la que el activo debe considerarse «al final de su vida útil» utilizando un objeto de fecha y hora.

Tipo: DateTime
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: Falso
Posición: Nombrada
Valor por defecto: Ninguno
Acepta entrada del pipeline: Falso
Acepta caracteres comodín: Falso

-ExpectedLifetime

Introduce la vida útil prevista del dispositivo. Ten en cuenta que solo son valores válidos «1 año», «2 años», «3 años», «4 años» y «5 años».

Tipo: Cadena
Conjuntos de parámetros: IndividualProperties
Alias:
Valores aceptados: 1 año, 2 años, 3 años, 4 años, 5 años
Obligatorio: Falso
Posición: Nombrada
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-Force

Si no se especifica el parámetro Confirm, el parámetro Force anulará a ShouldProcess y permitirá que el cmdlet continúe con el procesamiento.

Tipo: SwitchParameter
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

-ID

Especifica el ID de dispositivo NinjaOne del dispositivo no gestionado que se va a actualizar. Puedes recuperar el ID del dispositivo mediante el cmdlet Get-NinjaUnmanagedDevice.

Tipo: Int32
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: False
Posición: 0
Valor predeterminado: Ninguno
Acepta entrada de canalización: False
Acepta caracteres comodín: False

-InputObject

Especifica un objeto que se va a procesar en lugar de utilizar parámetros individuales. El objeto debe contener una propiedad para el ID del dispositivo y, opcionalmente, puede incluir propiedades para cualquiera de los demás atributos que se puedan actualizar.

Tipo: PSObject
Conjuntos de parámetros: Pipeline
Alias:
Obligatorio: False
Posición: 0
Valor predeterminado: Ninguno
Acepta entrada de canalización: True (ByValue)
Acepta caracteres comodín: False

-Name

Introduce el nombre del dispositivo no gestionado que deseas crear.

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

-ImporteDeCompra

Guarda el importe gastado en la compra del dispositivo.

Tipo: Decimal
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: Falso
Posición: Nombrado
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-PurchaseDate

Especifica la fecha en la que se compró el dispositivo utilizando un objeto de fecha y hora.

Tipo: DateTime
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: Falso
Posición: Nombrado
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-WarrantyEndDate

Especifica la fecha de finalización de la garantía del dispositivo mediante un objeto de fecha y hora.

Tipo: DateTime
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: False
Posición: Nombrado
Valor por defecto: Ninguno
Acepta entrada de canalización: False
Acepta caracteres comodín: False

-WarrantyStartDate

Especifica la fecha de inicio de la garantía del dispositivo mediante un objeto de fecha y hora.

Tipo: DateTime
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: False
Posición: Nombrado
Valor por defecto: Ninguno
Acepta entrada de canalización: False
Acepta caracteres comodín: False

-WhatIf

Muestra lo que ocurriría si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Parámetros comunes

Este cmdlet admite los 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.Object

El parámetro InputObject acepta un PSObject que contenga las propiedades del dispositivo no gestionado que se va a actualizar. El objeto debe incluir una propiedad para el ID del dispositivo y, opcionalmente, puede incluir propiedades para cualquiera de los demás atributos que se puedan actualizar.

System.String

La mayoría de los parámetros de este cmdlet aceptan entradas de cadena cuando no se utiliza el parámetro InputObject, como Name, Role y Relation.

System.DateTime

Parámetros como «PurchaseDate», «WarrantyStartDate» y «WarrantyEndDate» aceptan entradas de tipo «DateTime» cuando no se utiliza el parámetro «InputObject».

System.Decimal

El parámetro PurchaseAmount admite entradas decimales cuando no se utiliza el parámetro InputObject.

System.Hashtable

El parámetro CustomFieldHashtable admite entradas de tipo tabla hash cuando no se utiliza el parámetro InputObject.

Salidas

System.Object

Recursos adicionales

Para obtener más información sobre la gestión de activos y la creación de scripts personalizados, consulta los siguientes recursos:

• Gestión de terminales de NinjaOne: Índice de comandos y artículos de PowerShell 
• Gestión de activos de tecnología de la información (ITAM)
• NinjaOne ITAM: Introducción
• 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)