命名空间: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 为默认值。 可能的值包括 application、deviceConfiguration、deviceManagementConfigurationPolicy、mobileAppConfiguration、unknownFutureValue。 |
| 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 是默认值。 此属性是只读的。 可能的值包括 remove、restore、unknownFutureValue。 |
| assignmentItemActionStatus | deviceAssignmentItemStatus | 指示应用程序或配置在托管设备上执行的作的实时状态。 只读。 在作结果中返回。 可能的值包括:initiated、inProgress、removed、error、succeeded。 启动状态为默认值。 此属性是只读的。 可能的值包括 initiated、inProgress、removed、error、succeeded、unknownFutureValue。 |
| 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)"
}