Get-MsolDevice

  • リファレンス
モジュール:
MSOnline

個々のデバイスまたはデバイスの一覧を取得します。

構文

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 パラメーターは使用されないため、デバイス オブジェクトには登録済みのOwners プロパティは含まれません。

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

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

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

例 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"

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

例 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

このコマンドレットによってすべての結果が返されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceId

このコマンドレットが取得するデバイスのデバイス ID を指定します。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IncludeSystemManagedDevices

このコマンドレットに、自動パイロットなどのシステムによって管理されるデバイスが含まれることを示します。

Type:SwitchParamater
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LogonTimeBefore

デバイスリストのフィルター処理に使用する日付 (UTC) を指定しました。

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

このコマンドレットが取得するデバイスの表示名を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

このコマンドレットが取得するデバイスの一意のオブジェクト ID を指定します。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RegisteredOwnerUpn

デバイスの登録済み所有者であるユーザー オブジェクトを指定します。 ユーザー プリンシパル名 (UPN) または ObjectId を指定するか、ユーザーの UPN または ObjectId を含む Microsoft.Online.Administration.User オブジェクトのインスタンスを渡す必要があります。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnRegisteredOwners

このコマンドレットは、デバイスの 登録済みOwners プロパティを返します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

出力

Microsoft.Online.Administration.Device

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

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