裝置實體的參考

發行項
12/06/2023

裝置類別包含追蹤資訊的行動裝置實體，例如：

裝置類型
裝置註冊和註冊狀態
裝置擁有權
裝置管理狀態
裝置成員資格至Microsoft Entra狀態
註冊狀態
裝置的歷史資訊
清查裝置上的應用程式

deviceTypes

deviceTypes實體代表其他資料倉儲實體所參考的裝置類型。裝置類型通常會描述裝置型號、製造商或兩者的組合。

屬性	說明
deviceTypeID	裝置類型的唯一識別碼
deviceTypeKey	資料倉儲中裝置類型的唯一識別碼 - Surrogate 索引鍵
deviceTypeName	裝置類型

範例

deviceTypeID	名稱	描述
0	電腦	Windows 桌面裝置
1	WindowsRT	WindowsRT 裝置
2	WinMO6	Windows Mobile 6.0 裝置
3	諾基亞	Nokia 裝置
4	WindowsPhone	Windows Phone裝置
5	Mac	Mac 裝置
6	畏縮	Windows CE裝置
7	WinEmbedded	Windows Embedded 裝置
8	Iphone	iPhone 裝置
9	Ipad	iPad 裝置
10	Ipod	iPod 裝置
11	Android	使用裝置系統管理員管理 Android 裝置
12	ISocConsumer	iSoc 取用者裝置
14	MacMDM	使用內建 MDM 代理程式管理的 OS X 裝置
15	HoloLens	HoloLens 裝置
16	SurfaceHub	Surface Hub 裝置
17	AndroidForWork	使用 Android 設定檔擁有者管理的 Android 裝置
100	黑莓	Blackberry 裝置
101	棕櫚	手掌裝置
255	Unknown	未知的裝置類型

enrollmentActivities

enrollmentActivity實體表示裝置註冊的活動。

屬性	說明
dateKey	記錄此註冊活動的日期索引鍵。
deviceEnrollmentTypeKey	註冊類型的索引鍵。
deviceTypeKey	裝置類型的索引鍵。
enrollmentEventStatusKey	狀態的索引鍵，指出註冊成功或失敗。
enrollmentFailureCategoryKey	註冊失敗類別的索引鍵 (註冊失敗) 。
enrollmentFailureReasonKey	註冊失敗原因的索引鍵 (註冊失敗) 。
osVersion	裝置的作業系統版本。
Count	符合上述分類的註冊活動總數。

enrollmentEventStatuses

enrollmentEventStatus實體會指出裝置註冊的結果。

屬性	說明
enrollmentEventStatusKey	資料倉儲中註冊狀態的唯一識別碼 (代理金鑰)
enrollmentEventStatusName	註冊狀態的名稱。請參閱下列範例。

範例

enrollmentEventStatusName	說明
成功	裝置註冊成功
失敗	失敗的裝置註冊
無法使用	註冊狀態無法使用。

enrollmentFailureCategories

EnrollmentFailureCategory實體指出裝置註冊失敗的原因。

屬性	說明
enrollmentFailureCategoryKey	資料倉儲中註冊失敗類別的唯一識別碼 (代理金鑰)
enrollmentFailureCategoryName	註冊失敗類別目錄的名稱。請參閱下列範例。

範例

enrollmentFailureCategoryName	說明
不適用	註冊失敗類別不適用。
無法使用	無法使用註冊失敗類別。
Unknown	未知的錯誤。
驗證	驗證失敗。
授權	通話已通過驗證，但未獲得註冊授權。
AccountValidation	無法驗證註冊的帳戶。 (帳戶遭到封鎖，註冊未啟用)
UserValidation	無法驗證使用者。 (使用者不存在，遺漏授權)
DeviceNotSupported	行動裝置管理不支援裝置。
InMaintenance	帳戶正在維護中。
BadRequest	用戶端傳送了服務無法理解/支援的要求。
FeatureNotSupported	此帳戶不支援此註冊所使用的功能 () 。
EnrollmentRestrictionsEnforced	系統管理員所設定的註冊限制已封鎖此註冊。
ClientDisconnected	使用者已中止用戶端逾時或註冊。
UserAbandonment	使用者已放棄註冊。 (使用者開始上線，但無法及時完成)

enrollmentFailureReasons

EnrollmentFailureReason實體指出指定失敗類別內裝置註冊失敗的更詳細原因。

屬性	說明
enrollmentFailureReasonKey	資料倉儲中註冊失敗原因的唯一識別碼， (代理金鑰)
enrollmentFailureReasonName	註冊失敗原因的名稱。請參閱下列範例。

範例

enrollmentFailureReasonName	說明
不適用	註冊失敗原因不適用。
無法使用	無法使用註冊失敗原因。
Unknown	未知的錯誤。
UserNotLicensed	在 Intune 中找不到使用者，或沒有有效的授權。
UserUnknown	Intune 不知道使用者。
BulkAlreadyEnrolledDevice	只有一位使用者可以註冊裝置。此裝置先前已由另一位使用者註冊。
EnrollmentOnboardingIssue	尚未設定 MDM) 授權單位 (Intune 行動裝置管理。
AppleChallengeIssue	iOS 管理設定檔安裝已延遲或失敗。
AppleOnboardingIssue	必須要有 Apple MDM 推播憑證，才能註冊到 Intune。
DeviceCap	使用者嘗試註冊的裝置數目超過允許的上限。
AuthenticationRequirementNotMet	Intune 註冊服務無法授權此要求。
UnsupportedDeviceType	此裝置不符合 Intune 註冊的最低需求。
EnrollmentCriteriaNotMet	此裝置無法註冊，因為已設定註冊限制規則。
BulkDeviceNotPreregistered	找不到此裝置的國際行動設備識別碼 (IMEI) 或序號。若沒有此識別碼，則會將裝置辨識為目前遭到封鎖的個人擁有裝置。
FeatureNotSupported	使用者嘗試存取尚未為所有客戶發行或與您的 Intune 設定不相容的功能。
UserAbandonment	使用者已放棄註冊。 (使用者開始上線，但無法及時完成)
APNSCertificateExpired	無法使用過期的 Apple MDM 推播憑證來管理 Apple 裝置。

ownerTypes

ownerType實體會指出裝置為公司、個人擁有或未知。

屬性	描述	範例
ownerTypeID	擁有者類型的唯一識別碼。
ownerTypeKey	資料倉儲中擁有者類型的唯一識別碼 - Surrogate 索引鍵。
ownerTypeName	代表裝置的擁有者類型：公司 - 裝置為企業擁有。個人 - 裝置是 BYOD) (個人擁有。未知 - 此裝置上沒有任何資訊。	公司個人未知

注意事項

ownerTypeName針對在 AzureAD 中建立裝置動態群組時的，您需要將篩選值 deviceOwnership 設定為 Company 。如需詳細資訊，請參閱裝置規則。

managementStates

managementStates實體會提供裝置狀態的詳細資料。在套用遠端動作、裝置已越獄或 Root 破解的情況下，詳細資料可能很有用。

屬性	說明
managementStateID	管理狀態的唯一識別碼。
managementStateKey	資料倉儲中管理狀態的唯一識別碼 - Surrogate 索引鍵。
managementStateName	指出套用至此裝置的遠端動作狀態。

範例

managementStateID	名稱	描述
0	受管理	在沒有暫止遠端動作的管理中。
1	RetirePending	裝置有待淘汰命令。
2	RetireFailed	裝置上的淘汰命令失敗。
3	WipePending	裝置有擱置中的抹除命令。
4	WipeFailed	裝置上的抹除命令失敗。
5	狀況不良	狀況不良的狀態。
6	DeletePending	裝置有擱置中的刪除命令。
7	RetireIssued	已向裝置發出淘汰命令。
8	WipeIssued	已發出抹除命令。
9	WipeCanceled	已取消抹除命令。
10	RetireCanceled	已取消淘汰命令。
11	已探索	Intune 會新探索到裝置，一旦它第一次簽入，就會移至 -Managed- 狀態。

managementAgentTypes

ManagementAgentType實體代表用來管理裝置的代理程式。

屬性	說明
managementAgentTypeID	管理代理程式類型的唯一識別碼。
managementAgentTypeKey	資料倉儲中管理代理程式類型的唯一識別碼 - Surrogate 索引鍵。
managementAgentTypeName	指出用來管理裝置的代理程式類型。

範例

ManagementAgentTypeID	名稱	描述
1	大通	裝置是透過 Exchange Active Sync 來管理。
2	MDM	裝置是使用 MDM 代理程式來管理。
3	EasMdm	裝置是由 Exchange Active Sync 和 MDM 代理程式所管理。
4	IntuneClient	裝置是由 Intune 電腦代理程式管理。
5	EasIntuneClient	裝置是由 Exchange Active Sync 和 Intune 電腦代理程式所管理。
8	ConfigManagerClient	裝置是由Configuration Manager代理程式所管理。
16	Unknown	未知的管理代理程式類型。
2048	IntuneAosp	裝置是由 Intune 的 AOSP MDM (Android 開放原始碼專案) 裝置所管理。

devices

裝置實體會列出管理下的所有已註冊裝置及其對應的屬性。

屬性	說明
deviceKey	資料倉儲中裝置的唯一識別碼 - Surrogate 索引鍵。
deviceId	裝置的唯一識別碼。
deviceName	允許命名裝置之平臺上的裝置名稱。在其他平臺上，Intune 會從其他屬性建立名稱。此屬性無法供所有裝置使用。
deviceTypeKey	此裝置的裝置類型屬性索引鍵。
deviceRegistrationState	此裝置的用戶端註冊狀態屬性索引鍵。
ownerTypeKey	此裝置的擁有者類型屬性索引鍵：公司、個人或未知。
enrolledDateTime	註冊此裝置的日期和時間。
lastSyncDateTime	上次使用 Intune 的已知裝置簽入。
managementAgentKey	與此裝置相關聯之管理代理程式的金鑰。
managementStateKey	與此裝置相關聯之管理狀態的索引鍵，指出遠端動作的最新狀態，或是已進行 JB/Root 破解。
azureADDeviceId	此裝置的 Azure deviceID。
azureADRegistered	裝置是否Microsoft Entra註冊。
deviceCategoryKey	與此裝置相關聯之類別的索引鍵。
deviceEnrollmentType	與此裝置相關聯的註冊類型索引鍵，表示註冊方法。
complianceStateKey	與此裝置相關聯之合規性狀態的索引鍵。
osVersion	裝置的作業系統版本。
easDeviceId	Exchange ActiveSync裝置的識別碼。
serialNumber	SerialNumber
userId	與裝置相關聯之使用者的唯一識別碼。
rowLastModifiedDateTimeUTC	上次在資料倉儲中修改此裝置的 UTC 日期和時間。
製造商	裝置製造商
型號	裝置的型號
operatingSystem	裝置的作業系統。 Windows、iOS/iPadOS 等。
isDeleted	二進位檔，以顯示是否刪除裝置。
androidSecurityPatchLevel	Android 安全性修補程式層級
大臡	大臡
isSupervised	裝置受監督狀態
freeStorageSpaceInBytes	以位元組為單位的免費儲存體。
totalStorageSpaceInBytes	以位元組為單位的總儲存體。
encryptionState	裝置上的加密狀態。
subscriberCarrier	裝置的訂閱者電信業者
phoneNumber	裝置的電話號碼
Imei	Imei
cellularTechnology	裝置的行動電話技術
WiFiMacAddress	Wi-Fi MAC
Iccd	整合電路卡識別碼
windowsOsEdition	Windows 作業系統版本。
ethernetMacAddress	此裝置的唯一網路識別碼。
型號	裝置型號。
office365Version	安裝在裝置上的 Microsoft 365 版本。 `Office365Version` 只有在 Windows 電腦上安裝 Intune 管理延伸模組代理程式時才會收集。系統管理員也必須建立並指派 PowerShell 或 Win32 應用程式，才能安裝代理程式。如需詳細資訊，請參閱在Intune 中Windows 10裝置上使用 PowerShell 腳本和在Microsoft Intune 中使用 Win32 應用程式管理。注意： Intune Data Warehouse devices資料表有已知問題。裝置 `office365Version` 記錄的屬性可能是 Null。這個屬性目前正在維護中，可能會被取代。因此，您應該考慮不要將此屬性值用於報告用途。
SubnetAddressV4Wifi	IPV4 Wifi 連線的子網位址。
IpAddressV4Wifi	IPV4 Wifi 連線的 IP 位址。