Add-EntraDeviceRegisteredUser

モジュール:
Microsoft.Entra.DirectoryManagement Module v1.3

デバイスの登録済みユーザーを追加します。

構文

Default (既定) 

Add-EntraDeviceRegisteredUser

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

説明

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
DontShow:False
Aliases:オブジェクト識別子

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-UserId

ユーザーの ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:RefObjectId

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。