Add-EntraDeviceRegisteredUser

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Agrega un usuario registrado para un dispositivo.

Sintaxis

Default (valor predeterminado) 

Add-EntraDeviceRegisteredUser

    -DeviceId <String>
    -UserId <String>
    [<CommonParameters>]

Description

El Add-EntraDeviceRegisteredUser cmdlet agrega un usuario registrado para un dispositivo Microsoft Entra ID.

En escenarios delegados que implican cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener un rol de Microsoft Entra compatible o un rol personalizado con los permisos necesarios. Se admiten los siguientes roles con privilegios mínimos para esta operación:

  • Administrador de Intune
  • Administrador de Windows 365

Ejemplos

Ejemplo 1: Agregar un usuario como usuario registrado

Connect-Entra -Scopes 'Device.ReadWrite.All'
$user = Get-EntraUser -UserId 'SawyerM@contoso.com'
$device = Get-EntraDevice -SearchString '<device-display-name>'
Add-EntraDeviceRegisteredUser -DeviceId $device.Id -UserId $user.Id

En este ejemplo se muestra cómo agregar un usuario registrado a un dispositivo.

  • -DeviceId el parámetro especifica el identificador único (id. de objeto) del dispositivo al que desea agregar un usuario registrado. Puede usar el comando Get-EntraDevice para obtener el identificador del dispositivo.
  • -UserId el parámetro especifica el identificador único (id. de objeto) del usuario que se agregará como usuario registrado del dispositivo. Puede usar el comando Get-EntraUser para obtener el identificador de usuario.

Parámetros

-DeviceId

Especifica el identificador del dispositivo.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto)

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-UserId

Especifica el identificador del usuario.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:RefObjectId

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.