Add-EntraDeviceRegisteredUser

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

Adiciona um utilizador registado para um dispositivo.

Sintaxe

Default (Predefinição) 

Add-EntraDeviceRegisteredUser

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

Descrição

O Add-EntraDeviceRegisteredUser cmdlet adiciona um utilizador registado para um dispositivo Microsoft Entra ID.

Em cenários delegados envolvendo contas de trabalho ou escola, o utilizador iniciado deve ter um papel Microsoft Entra suportado ou um cargo personalizado com as permissões necessárias. Os seguintes papéis menos privilegiados são suportados para esta operação:

  • Administrador do Intune
  • Administrador do Windows 365

Exemplos

Exemplo 1: Adicionar um utilizador como utilizador registado

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

Este exemplo mostra como adicionar um utilizador registado a um dispositivo.

  • -DeviceId parâmetro especifica o identificador único (ID do Objeto) do dispositivo ao qual pretende adicionar um utilizador registado. Podes usar o comando Get-EntraDevice para obter o ID do dispositivo.
  • -UserId o parâmetro especifica o identificador único (ID do Objeto) do utilizador que será adicionado como utilizador registado do dispositivo. Podes usar o comando Get-EntraUser para obter o ID do utilizador.

Parâmetros

-DeviceId

Especifica o ID do dispositivo.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IdentificadorDoObjeto

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-UserId

Especifica o ID do utilizador.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:RefObjectId

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.