Get-MsolDevice

構文

Get-MsolDevice
   -Name <String>
   [<CommonParameters>]

Get-MsolDevice
   [-All]
   [-ReturnRegisteredOwners]
   [<CommonParameters>]

Get-MsolDevice
   -DeviceId <Guid>
   [<CommonParameters>]

Get-MsolDevice
   -All
   -LogonTimeBefore <DateTime>
   [<CommonParameters>]

Get-MsolDevice
   -ObjectId <Guid>
   [<CommonParameters>]

Get-MsolDevice
   -RegisteredOwnerUpn <String>
   [<CommonParameters>]

Get-MsolDevice
   -All
   -IncludeSystemManagedDevices
   [<CommonParameters>]

説明

Get-MsolDevice コマンドレットは、個々のデバイスまたはデバイスの一覧を取得します。

例

例 1: デバイス オブジェクトを取得する

PS C:\>Get-MsolDevice -Name "NIC0123"

このコマンドは、NIC0123という名前のデバイス オブジェクトを取得します。

例 2: デバイス オブジェクトの一覧を取得する

PS C:\>Get-MsolDevice -All

このコマンドは、デバイス オブジェクトの一覧を取得します。 ReturnRegisteredOwners パラメーターは使用されないため、デバイス オブジェクトには registeredOwners プロパティは含まれません。

例 3: registeredOwners プロパティを含むデバイス オブジェクトの一覧を取得する

PS C:\>Get-MsolDevice -All -ReturnRegisteredOwners

このコマンドは、デバイス オブジェクトの一覧を取得します。 ReturnRegisteredOwners パラメーターが使用されているため、デバイス オブジェクトには registeredOwners プロパティが含まれています。

例 4: デバイス ID でデバイスを取得する

PS C:\>Get-MsolDevice -DeviceId "1aa200c4-bdfb-42b5-9a1e-5f1bafbe4274"

このコマンドは、対応するデバイス ID を持つデバイスを取得します。

例 5: オブジェクト ID でデバイス オブジェクトを取得する

PS C:\>Get-MsolDevice -ObjectId "566F7EA7-7BF1-4F4A-AF23-A1B46DBD46D6"

このコマンドは、対応するオブジェクト ID を持つデバイスを取得します。

例 6: UPN によって登録されたデバイスを取得する

PS C:\>Get-MsolDevice -RegisteredOwnerUpn "pattifuller@contoso.com"

このコマンドは、 という名前 pattifuller@contoso.comの UPN を使用してユーザーによって登録されたすべてのデバイスを取得します。

例 7: アクティビティ (ログオン) タイムスタンプでデバイスを取得する

PS C:\>Get-MsolDevice -All -LogonTimeBefore 'January 1, 2017 12:00:00 AM'

Ths コマンドは、2017 年 1 月 1 日より前に ApproximateLastLogonTimestamp を使用するすべてのデバイスを取得します

例 8: デバイスを取得し、システムマネージド デバイスを含める

PS C:\>Get-MsolDevice -All -IncludeSystemManagedDevices

このコマンドは、すべてのデバイスを取得し、自動パイロット デバイスと Intune で使用されるその他のデバイス (EAS など) を含みます

パラメーター

-All

-DeviceId

-IncludeSystemManagedDevices

-LogonTimeBefore

-Name

-ObjectId

-RegisteredOwnerUpn

-ReturnRegisteredOwners

出力

Microsoft.Online.Administration.Device

このコマンドレットは、次の情報を含むデバイス オブジェクトを返します。

• AccountEnabled: デバイスの状態: 有効または無効。
• ObjectId: デバイスの一意の ID。
• DeviceId: デバイスのデバイス ID。
• DisplayName: デバイスの表示名。
• DeviceObjectVersion: デバイスのオブジェクトのバージョン番号。
• DeviceOSType: デバイス オペレーティング システムの種類。
• DeviceOSVersion: デバイス オペレーティング システムのバージョン番号。
• DeviceTrustType: デバイスの信頼の種類。 値には、Workplace Joined、AzureAD Joined、Domain Joined のいずれかを指定できます。
• DeviceTrustLevel: デバイスの信頼レベル。 値には、Authenticated、Compliant、Managed のいずれかを指定できます。
• DevicePhysicalIds: デバイスの物理 ID。
• ApproximateLastLogonTimestamp: このデバイスを使用した最後のログオン タイムスタンプ。
• AlternativeSecurityIds: デバイスの代替セキュリティ ID。
• DirSyncEnabled: デバイスが DirSync で有効になっている場合。
• LastDirSyncTime: デバイスが DirSync によって同期された最後のタイムスタンプ。
• RegisteredOwners: デバイスの登録済み所有者。
• GraphDeviceObject: graph API から返されるデバイス オブジェクト。

関連リンク

• Disable-MsolDevice
• Enable-MsolDevice
• Remove-MsolDevice