Powershell: New-NinjaUnmanagedDevice

Tema

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

Si utilizas el módulo de PowerShell de NinjaOne fuera de un script de automatización, es posible que tengas que ajustar la política de ejecución de PowerShell. Para obtener más información sobre las políticas de ejecución, consulta la documentación de Microsoft: Acerca de las políticas de ejecución ( enlace externo).

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 (por defecto)

NinjaUnmanagedDevice [[-Name] <Cadena>] [-Role <Cadena>] [-Relation<Cadena>] [-AssetID <Cadena>][-AssetSerialNumber <Cadena>] [-AssetStatus <Cadena>] [-EndOfLifeDate<Fecha y hora>] [-ExpectedLifetime <Cadena>][-PurchaseAmount <Decimal>] [-PurchaseDate <Fecha y hora>] [-WarrantyStartDate<Fecha y hora>][-WarrantyEndDate <Fecha y hora>] [-CustomFieldHashtable <Tabla hash>] [-Force][-WhatIf] [-Confirm][<CommonParameters>]

Pipeline

New-NinjaUnmanagedDevice [[-InputObject] <Object>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Ejemplos

Ejemplo 1: Crear a partir de 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, una función de dispositivo no gestionad
e y una relación de entidad.

Ejemplo 2: Creación a partir de 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 ordenador 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 utilizando el formato de objeto de entrada, da formato a tu objeto tal y como se muestra
en el ejemplo anterior.

Ejemplo 3: Uso de la tabla hash de campos personalizados

$MyCustomFieldValues = @{
exampleTextField = "Mi valor de campo de texto personalizado"
}
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 a tu nuevo 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

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

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

-Confirmar

Le 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

-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:
Obligatorio: Falso
Posición: Nombrada
Valor por defecto: 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 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: (Todos)
Alias:
Obligatorio: 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 utilizar parámetros individuales.

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

-Nombre

Introduce el nombre del dispositivo no gestionado que deseas crear.

Tipo: Cadena
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: Falso
Posición: 0
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: 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 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

-Relation

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

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

-Rol

Especifica la función del dispositivo no gestionado.

Tipo: Cadena
Conjuntos de parámetros: IndividualProperties
Alias:
Obligatorio: Falso
Posición: Nombrada
Valor predeterminado: 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: 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 utilizando 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 del canal: 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: 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 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

System.Object

Este cmdlet puede aceptar un objeto como entrada a través de la canalización o especificando el parámetro InputObject.

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

Ninguna

NinjaOne mostrará el nuevo dispositivo no gestionado una vez completada la sincronización, lo que suele ocurrir en unos minutos.

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: