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>] Description
Get-MsolDevice Cmdlet 會取得個別裝置或裝置清單。
範例
範例 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：依裝置標識碼取得裝置
PS C:\>Get-MsolDevice -DeviceId "1aa200c4-bdfb-42b5-9a1e-5f1bafbe4274"此命令會取得具有對應裝置標識碼的裝置。
範例 5：依物件標識碼取得裝置物件
PS C:\>Get-MsolDevice -ObjectId "566F7EA7-7BF1-4F4A-AF23-A1B46DBD46D6"此命令會取得具有對應物件標識符的裝置。
範例 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
表示此 Cmdlet 會傳回所有結果。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeviceId
指定這個 Cmdlet 取得之裝置的裝置識別碼。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-IncludeSystemManagedDevices
指出此 Cmdlet 包含由系統管理的裝置，例如自動試驗。
| 類型: | SwitchParamater |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-LogonTimeBefore
指定用來篩選裝置清單的日期 (UTC) 。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定這個 Cmdlet 取得之裝置的顯示名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ObjectId
指定這個 Cmdlet 取得之裝置的唯一物件識別碼。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-RegisteredOwnerUpn
指定用戶物件，該對像是裝置的已註冊擁有者。 您必須提供用戶主體名稱 (UPN) 或 ObjectId，或傳遞包含使用者 UPN 或 ObjectId 的 Microsoft.Online.Administration.User 對象的實例。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ReturnRegisteredOwners
表示這個 Cmdlet 會傳回裝置的 registeredOwners 屬性。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸出
Microsoft.Online.Administration.Device
此 Cmdlet 會傳回裝置物件，其中包含下列資訊：
- AccountEnabled：裝置的狀態：已啟用或停用。
- ObjectId：裝置的唯一標識符。
- DeviceId：裝置的裝置標識碼。
- DisplayName：裝置的顯示名稱。
- DeviceObjectVersion：裝置的物件版本號碼。
- DeviceOSType：裝置操作系統類型。
- DeviceOSVersion：裝置操作系統版本號碼。
- DeviceTrustType：裝置信任類型。 此值可以是下列其中一項：已加入工作場所、已加入 AzureAD、已加入網域。
- DeviceTrustLevel：裝置信任層級。 此值可以是下列其中一項：已驗證、符合規範、受管理。
- DevicePhysicalIds：裝置實體標識符。
- ApproximateLastLogonTimestamp：使用此裝置的最後一個登入時間戳。
- AlternativeSecurityIds：裝置替代安全性標識碼。
- DirSyncEnabled：如果裝置已啟用 DirSync。
- LastDirSyncTime：裝置由 DirSync 同步處理的最後一個時間戳。
- RegisteredOwners：裝置的已註冊擁有者。
- GraphDeviceObject：從圖形 API 傳回的裝置物件。