Remove-EntraDeviceRegisteredUser

Entfernt einen registrierten Benutzer von einem Gerät.

Syntax

Default (Standard)

Remove-EntraDeviceRegisteredUser

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

Beschreibung

Das Remove-EntraDeviceRegisteredUser Cmdlet entfernt einen registrierten Benutzer von einem Microsoft Entra ID Gerät.

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss der angemeldete Benutzer über eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit den erforderlichen Berechtigungen verfügen. Für diesen Vorgang werden die folgenden Rollen mit den geringsten Berechtigungen unterstützt:

  • Intune-Administrator
  • Windows 365-Administrator

Beispiele

Beispiel 1: Entfernen eines registrierten Benutzers von einem Gerät

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

In diesem Beispiel wird gezeigt, wie der registrierte Benutzer vom Gerät entfernt wird.

Parameter

-DeviceId

Gibt die ID eines Objekts an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-UserId

Gibt die ID eines Benutzers an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.