Add-EntraDeviceRegisteredUser

模組:
Microsoft.Entra.DirectoryManagement Module v1.3

新增一個裝置的註冊使用者。

語法

Default (預設值) 

Add-EntraDeviceRegisteredUser

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

Description

該Add-EntraDeviceRegisteredUser指令小程式會為 Microsoft Entra ID 裝置新增一個註冊使用者。

在涉及工作或學校帳號的委派情境中，登入使用者必須擁有支援的 Microsoft Entra 角色或具備所需權限的自訂角色。 以下支援的最低權限角色用於此操作：

  • Intune 管理員
  • Windows 365 管理員

範例

範例 1：將使用者新增為註冊使用者

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

這個範例展示了如何將註冊使用者加入裝置。

  • -DeviceId 參數指定你想新增註冊使用者的裝置的唯一識別碼（物件 ID）。 你可以用這個指令 Get-EntraDevice 取得裝置 ID。
  • -UserId 參數指定將被加入為裝置註冊使用者的唯一識別碼（物件 ID）。 你可以用這個指令 Get-EntraUser 取得使用者 ID。

參數

-DeviceId

指定裝置的 ID。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False
別名:ObjectId (物件識別碼)

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-UserId

指定使用者的 ID。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False
別名:RefObjectId

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。