¿Ya eres cliente de NinjaOne? Inicia sesión para ver más guías y las últimas actualizaciones.

Powershell: Establecer usuario Ninja

  • Última actualización 21 de julio de 2026

Tema

En este artículo se explica cómo utilizar Set-NinjaUser para asignar un usuario específico a un dispositivo.

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 Set-NinjaUser asigna un usuario específico a un dispositivo. El usuario se identifica mediante su dirección de correo electrónico y puede ser un usuario final, un técnico o un contacto. Si una cuenta o un contacto está limitado a una organización, NinjaOne solo emparejará los dispositivos que pertenezcan a la misma organización que el usuario. Los técnicos deben tener permiso para acceder al dispositivo. 

Este cmdlet debe ejecutarse dentro de un script de automatización de Ninja para modificar el usuario asignado.
Las actualizaciones del usuario asignado se mostrarán en la interfaz web de NinjaOne tras una sincronización correcta, lo que suele ocurrir en unos minutos.

Sintaxis

Set-NinjaUser [-EmailAddress] <String> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Ejemplos

Ejemplo 1: Asignar un usuario - Script de automatización

PS C:> Set-NinjaUser -EmailAddress "[email protected]"
Solicitud enviada correctamente al agente. Consulte el feed de actividad del dispositivo para confirmar que
se ha asignado el usuario.

El usuario con la dirección de correo electrónico «[email protected]» ha sido asignado al dispositivo especificado.

Ejemplo 2: Asignar un usuario - Terminal activa

PS C:> Set-NinjaUser -EmailAddress "[email protected]"
Set-NinjaUser : El acceso para configurar el usuario solo es posible desde un script de automatización
En la línea: 1, carácter: 1
+ Set-NinjaUser -EmailAddress "[email protected]"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : FromStdErr: (:) [Write-Error],
WriteErrorException
+ FullyQualifiedErrorId :
Microsoft.PowerShell.Commands.WriteErrorException,Set-NinjaUser

Solo se puede asignar un usuario desde un script de automatización, por lo que se devuelve un mensaje de error al intentar ejecutar el cmdlet en una sesión de terminal activa.

Parámetros

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

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

Especifica la dirección de correo electrónico del usuario que se va a asignar al dispositivo. El usuario ya debe existir en NinjaOne como usuario final, técnico o contacto.

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

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

Tipo: SwitchParameter
Conjuntos de parámetros: (Todos)
Alias:
Obligatorio: Falso
Posición: Nombrada
Valor predeterminado: Ninguno
Acepta entrada de canalización: Falso
Acepta caracteres comodín: Falso
-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.String

Este cmdlet acepta una cadena que representa la dirección de correo electrónico del usuario que se va a asignar al dispositivo.

Salidas

Ninguna

  • El usuario debe figurar ya en NinjaOne como usuario final, técnico o contacto.
  • NinjaOne mostrará el nuevo dispositivo no gestionado una vez que la sincronización se haya realizado correctamente, 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:

FAQ

Próximos pasos