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 パラメーターは使用されないため、デバイス オブジェクトには登録済みの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 から返されるデバイス オブジェクト。
関連リンク
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示