deviceAssignmentItem 资源类型

命名空间:microsoft.graph

重要:Microsoft支持Intune /beta API,但它们会受到更频繁的更改。 Microsoft建议尽可能使用版本 v1.0。 使用版本选择器检查 API 在 v1.0 版中的可用性。

注意:适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证

表示 ChangeAssignments作执行或结果中包含的应用程序或配置。 对于作执行,它表示打算在托管设备上卸载或删除的应用程序或配置。 对于作结果,它表示此应用程序或配置的实时报告数据,以及其删除或还原过程。

属性

属性 类型 说明
itemId String 应用程序或配置的唯一标识符。 ItemId 是必需属性,需要在要删除的 DeviceAssignmentItem 的 action POST 请求参数中设置该属性。 最大长度为 40
itemType deviceAssignmentItemType 指示应用程序或配置类型。 ItemType 是必需属性,需要在要删除的 DeviceAssignmentItem 的 ACTION POST 请求参数中设置该属性。 可能的值包括:application、deviceConfiguration、deviceManagementConfigurationPolicy、mobileAppConfiguration。 application itemType 为默认值。 可能的值包括 applicationdeviceConfigurationdeviceManagementConfigurationPolicymobileAppConfigurationunknownFutureValue
itemSubTypeDisplayName String 指示应用程序或配置的特定类型。 例如,未知、application、appConfiguration、exploitProtection、bitLocker、deviceControl、 microsoftEdgeBaseline, attackSurfaceReductionRulesConfigMgr, endpointDetectionandResponse, windowsUpdateforBusiness, microsoftDefenderFirewallRules, applicationControl, microsoftDefenderAntivirusexclusions, microsoftDefenderAntivirus, wiredNetwork, derivedPersonalIdentityVerificationCredential, windowsHealthMonitoring, extensions, mxProfileZebraOnly,deviceFirmwareConfigurationInterface, deliveryOptimization, identityProtection, kiosk, overrideGroupPolicy, domainJoinPreview, pkcsImportedCertificate, networkBoundary, endpointProtection, microsoftDefenderAtpWindows10Desktop, sharedMultiUserDevice, deviceFeatures, secureAssessmentEducation, wiFiImport, editionUpgradeAndModeSwitch, vpn, custom, softwareUpdates, deviceRestrictionsWindows10Team, email, trustedCertificate, scepCertificate, emailSamsungKnoxOnly,pkcsCertificate, deviceRestrictions, wiFi, settingsCatalog. 只读。 在作结果中返回。 默认值为 null。 无法修改属性值,并且会自动填充作结果。 最大长度为 200。 此属性是只读的。
itemDisplayName String 应用程序或配置的项 displayName 名称。 只读。 在作结果中返回。 默认值为 null。 无法修改属性值,并且会自动填充作结果。 最大长度为 200。 此属性是只读的。
assignmentItemActionIntent deviceAssignmentItemIntent 指示 IT 管理员在托管设备上执行此作时对应用程序或配置的意图。 意向需要设置为 action POST 请求参数中的默认值 remove。 对于打算通过以前的作删除但当前作中未包含的应用程序或配置,其意向将在作结果中报告为还原。 可能的值是:remove、restore。 remove intent 是默认值。 此属性是只读的。 可能的值包括 removerestoreunknownFutureValue
assignmentItemActionStatus deviceAssignmentItemStatus 指示应用程序或配置在托管设备上执行的作的实时状态。 只读。 在作结果中返回。 可能的值包括:initiated、inProgress、removed、error、succeeded。 启动状态为默认值。 此属性是只读的。 可能的值包括 initiatedinProgressremovederrorsucceededunknownFutureValue
intentActionMessage String 有关在托管设备上执行的作的应用程序或配置的意向作消息。 当作出错时,此属性提供有关失败原因的消息。 作正在进行时,此属性提供有关设备上正在处理的内容的消息。 只读。 在作结果中返回。 可以为 null。 最大长度为 1500。 此属性是只读的。
errorCode Int64 应用程序或配置的错误代码,说明在托管设备上执行了失败的作。 只读。 在作结果中返回。 0 是默认值,表示没有失败。 有效值 -9.22337203685478E+18 到 9.22337203685478E+18。 此属性是只读的。
lastActionDateTime DateTimeOffset 启动应用程序或配置执行作的日期和时间。 只读。 在作结果中返回。 无法修改属性值,并在启动作时自动填充。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2025 年 1 月 1 日午夜 UTC 如下所示:“2025-01-01T00:00:00Z”。 此属性是只读的。
lastModifiedDateTime DateTimeOffset 上次因作执行或状态更改而修改应用程序或配置的日期和时间。 只读。 在作结果中返回。 无法修改属性值,并在启动作或设备状态发生更改时自动填充。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2025 年 1 月 1 日午夜 UTC 如下所示:“2025-01-01T00:00:00Z”。 此属性是只读的。

关系

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.deviceAssignmentItem",
  "itemId": "String",
  "itemType": "String",
  "itemSubTypeDisplayName": "String",
  "itemDisplayName": "String",
  "assignmentItemActionIntent": "String",
  "assignmentItemActionStatus": "String",
  "intentActionMessage": "String",
  "errorCode": 1024,
  "lastActionDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)"
}