Add-EntraDeviceRegisteredUser

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

Adiciona um usuário registrado para um dispositivo.

Sintaxe

Default (Default) 

Add-EntraDeviceRegisteredUser

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

Description

O Add-EntraDeviceRegisteredUser cmdlet adiciona um usuário registrado para um dispositivo Microsoft Entra ID.

Em cenários delegados envolvendo contas corporativas ou de estudante, o usuário conectado deve ter uma função de Microsoft Entra com suporte ou uma função personalizada com as permissões necessárias. As seguintes funções com menos privilégios são suportadas para esta operação:

  • Administrador do Intune
  • Administrador do Windows 365

Exemplos

Exemplo 1: Adicionar um usuário como um usuário 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

Este exemplo mostra como adicionar um usuário registrado a um dispositivo.

  • -DeviceId O parâmetro especifica o identificador exclusivo (ID do objeto) do dispositivo ao qual você deseja adicionar um usuário registrado. Você pode usar o comando Get-EntraDevice para obter a ID do dispositivo.
  • -UserId O parâmetro especifica o identificador exclusivo (ID do objeto) do usuário que será adicionado como um usuário registrado do dispositivo. Você pode usar o comando Get-EntraUser para obter a ID do usuário.

Parâmetros

-DeviceId

Especifica a ID do dispositivo.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-UserId

Especifica a ID do usuário.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:RefObjectId

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.