Add-EntraDeviceRegisteredUser

Fügt einen registrierten Benutzer für ein Gerät hinzu.

Syntax

Default (Standard)

Add-EntraDeviceRegisteredUser

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

Beschreibung

Das Add-EntraDeviceRegisteredUser Cmdlet fügt einen registrierten Benutzer für ein Microsoft Entra ID Gerät hinzu.

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: Hinzufügen eines Benutzers als registrierter Benutzer

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

In diesem Beispiel wird gezeigt, wie ein registrierter Benutzer zu einem Gerät hinzugefügt wird.

  • -DeviceId der Parameter gibt den eindeutigen Bezeichner (Objekt-ID) des Geräts an, dem Sie einen registrierten Benutzer hinzufügen möchten. Sie können den Befehl Get-EntraDevice verwenden, um die Geräte-ID abzurufen.
  • -UserId der Parameter gibt den eindeutigen Bezeichner (Object ID) des Benutzers an, der als registrierter Benutzer des Geräts hinzugefügt wird. Sie können den Befehl Get-EntraUser verwenden, um die Benutzer-ID abzurufen.

Parameter

-DeviceId

Gibt die ID des Geräts 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 des Benutzers an.

Parametereigenschaften

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

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.