Get-EntraUserOwnedDevice

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

ユーザーが所有する登録済みデバイスを取得します。

構文

Default (既定) 

Get-EntraUserOwnedDevice

    -UserId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [<CommonParameters>]

説明

Get-EntraUserOwnedDevice コマンドレットは、Microsoft Entra IDで指定されたユーザーが所有する登録済みデバイスを取得します。

例

例 1: ユーザーが所有するデバイスを取得する

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserOwnedDevice -UserId 'SawyerM@contoso.com'

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
bbbbbbbb-1111-2222-3333-cccccccccccc aaaa0000-bb11-2222-33cc-444444dddddd Device1
cccccccc-2222-3333-4444-dddddddddddd bbbb1111-cc22-3333-44dd-555555eeeeee Device2

このコマンドは、指定されたユーザーが所有する登録済みデバイスを取得します。

例 2: ユーザーが所有するすべてのデバイスを取得する

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserOwnedDevice -UserId 'SawyerM@contoso.com' -All

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
bbbbbbbb-1111-2222-3333-cccccccccccc aaaa0000-bb11-2222-33cc-444444dddddd Device1
cccccccc-2222-3333-4444-dddddddddddd bbbb1111-cc22-3333-44dd-555555eeeeee Device2

このコマンドは、指定されたユーザーが所有するすべての登録済みデバイスを取得します。

例 3: ユーザーが所有する上位 1 台のデバイスを取得する

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserOwnedDevice -UserId 'SawyerM@contoso.com' -Top 1

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
bbbbbbbb-1111-2222-3333-cccccccccccc aaaa0000-bb11-2222-33cc-444444dddddd Device1

このコマンドは、指定されたユーザーが所有する登録済みデバイスの上位 1 つを取得します。 -Limitのエイリアスとして-Topを使用できます。

パラメーター

-All

すべてのページを一覧表示します。

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

型:System.Management.Automation.SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

-Property

返されるプロパティを指定します。

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

型:

System.String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Select

パラメーター セット

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

-Top

返されるレコードの最大数を指定します。

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

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

パラメーター セット

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

-UserId

Microsoft Entra IDのユーザーの ID (ユーザー プリンシパル名または UserId として) を指定します。

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

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子, UPN, アイデンティティ, ユーザープリンシパルネーム

パラメーター セット

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

CommonParameters

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