Remove-EntraDeviceRegisteredUser

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

移除裝置上的註冊使用者。

語法

Default (預設值) 

Remove-EntraDeviceRegisteredUser

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

Description

該Remove-EntraDeviceRegisteredUser指令小程式會將註冊使用者從 Microsoft Entra ID 裝置中移除。

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

  • Intune 管理員
  • Windows 365 管理員

範例

範例 1：將註冊使用者從裝置中移除

Connect-Entra -Scopes 'Directory.AccessAsUser.All'
$device = Get-EntraDevice -Filter "DisplayName eq 'Woodgrove Desktop'"
$user = Get-EntraDeviceRegisteredUser -DeviceId $device.Id | Where-Object {$_.userPrincipalName -eq 'parker@contoso.com'}
Remove-EntraDeviceRegisteredUser -DeviceId $device.Id -UserId $user.Id

這個範例展示了如何將註冊使用者從裝置中移除。

參數

-DeviceId

指定物件的 ID。

參數屬性

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

參數集

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

-UserId

指定使用者的 ID。

參數屬性

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

參數集

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

CommonParameters

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