Powershell: New-NinjaUnmanagedDevice

Tema

En este artículo se explica cómo utilizar New-NinjaUnmanagedDevice para crear un nuevo dispositivo no gestionado con los detalles que especifiques.

Entorno

• NinjaOne
• Microsoft Powershell

Descripción

El cmdlet New-NinjaUnmanagedDevice crea un dispositivo no gestionado y lo asocia a una relación de activos especificada con el dispositivo actual. El nuevo dispositivo no gestionado se asigna automáticamente a la misma organización y ubicación que el dispositivo gestionado relacionado. 

Además, puede proporcionar varios campos opcionales para personalizar el dispositivo durante su creación, como las fechas de inicio y fin de la garantía u otros detalles relevantes. NinjaOne mostrará el nuevo dispositivo no gestionado una vez que la sincronización se haya realizado correctamente, lo que suele ocurrir en unos minutos.

Sintaxis

Propiedades individuales (predeterminadas)

NinjaUnmanagedDevice [[-Nombre <CADENA>] [-Función <CADENA>] [-Relation<CADENA>] [-AssetID <CADENA>][-AssetSerialNumber <CADENA>] [-AssetStatus <CADENA>] [-EndOfLifeDate<FECHAHORA>] [-ExpectedLifetime <CADENA>][-PurchaseAmount <DECIMAL>] [-PurchaseDate <FECHA y hora>] [-WarrantyStartDate<FECHA y hora>][-WarrantyEndDate <FECHA y hora>] [-CustomFieldHashtable <TABLA hash>] [-Force][-WhatIf] [-Confirmar][<PARÁMETROS comunes>]

Pipeline

New-NinjaUnmanagedDevice [[-InputObject] <OBJECT>] [-Force] [-WhatIf] [-Confirm] [<COMMONPARAMETERS>]

Ejemplos

Ejemplo 1: Crear desde propiedades individuales

PS C:> New-NinjaUnmanagedDevice -Name "AEG-12345 en el escritorio de Luke" -Role
"Monitores" -Relation "Conectado a"

La información mínima necesaria para crear un dispositivo no gestionado es su nombre,
su función de dispositivo no gestionado y su relación de entidad.

Ejemplo 2: Crear desde un objeto de entrada

$LukesMonitor = @{
assetId = "8675309"
assetSerialNumber = "9565035"
assetStatus = "En uso"
endOfLifeDate = "2027-02-21"
expectedLifetime = "1 año"
name = "AEG-12345 en el escritorio de Lukes"
purchaseAmount = 100,00
purchaseDate = "2026-02-21"
relation = "Conectado a"
Función = "Monitores"
fechaFinGarantía = "21/02/2027"
fechaInicioGarantía = "21/02/2026"
valoresCamposPersonalizados = @{
campoDeTextoDeEjemplo = "El valor de mi campo de texto"
}
}
PS C:> New-NinjaUnmanagedDevice -InputObject $LukesMonitor

Para especificar información adicional usando el formato de objeto de entrada, da formato a tu objeto tal y como se muestra
en el ejemplo anterior.

Ejemplo 3: Usar la tabla hash de campos personalizados

$MyCustomFieldValues = @{
exampleTextField = "Mi valor de campo personalizado de texto"
}
PS C:> New-NinjaUnmanagedDevice -Name "AEG-12345 en el escritorio de Luke" -Role
"Monitores" -Relation "Conectado a" -CustomFieldHashtable
$MyCustomFieldValues

Si desea utilizar propiedades individuales y especificar determinados valores de campos personalizados, puede utilizar
el parámetro CustomFieldHashtable.

Parámetros

-AssetID

Especifica un número de identificación para asociarlo con tu nuevo activo.

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

-AssetSerialNumber

Almacena los números de serie de los dispositivos no gestionados.

Tipo: Cadena
Conjuntos de parámetros: IndividualProperties
Alias:
Requerido: Falso
Posición: Nombrado
Valor predeterminado: 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:
Requerido: Falso
Posición: Nombrado
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-Confirmar

Solicita confirmación antes de ejecutar el cmdlet.

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

-ConfirmFieldHashtable

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:
Requerido: Falso
Posición: Nombrada
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» usando un objeto de fecha y hora.

Tipo: DateTime
Conjuntos de parámetros: IndividualProperties
Alias:
Requerido: Falso
Posición: Nombrada
Valor por defecto: Ninguno
Acepta entrada de canalización: 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á la propiedad
ShouldProcess y permitirá que el cmdlet continúe con el procesamiento.

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

-InputObject

Especifica un objeto que se va a procesar en lugar de usar parámetros individuales.

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

-Nombre

Introducir el nombre del dispositivo no gestionado que deseas crear.

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

-ImporteDeCompra

Guarda la cantidad gastada en la compra del dispositivo.

Tipo: Decimal
Conjuntos de parámetros: IndividualProperties
Alias:
Requerido: Falso
Posición: Nombrada
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 usando un objeto de fecha y hora.

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

-Relation

Especifica la relación del dispositivo no gestionado con el dispositivo actual.

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

-Función

Especifica la función del dispositivo no gestionado.

Tipo: Cadena
Conjuntos de parámetros: IndividualProperties
Alias:
Requerido: 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:
Requerido: Falso
Posición: Nombrado
Valor por defecto: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso

-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: (Todo)
Alias: wi
Requerido: False
Posición: Nombrada
Valor predeterminado: Ninguno
Acepta entrada de canalización: False
Acepta caracteres comodín: False

Parámetros comunes

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

Entradas

Sistema.Object

Este cmdlet puede aceptar un objeto como entrada por la canalización o especificando el parámetro InputObject.

Sistema.String

La mayoría de los parámetros de este cmdlet aceptan entradas de tipo cadena cuando no se usa el parámetro InputObject, como Nombre, Función y Relation.

El Sistema.DateTime

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

Sistema.Decimal

El parámetro PurchaseAmount acepta entradas decimales cuando no se usa el parámetro InputObject.

El Sistema.Hashtable

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

Salidas

Ninguno

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:

• 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)