用途
该技能面向 Microsoft Intune 的运维场景,提供一组确定性的运行手册(runbook),用于执行常见的 Intune 管理任务。其核心目标是在调用 Intune API 之前完成上下文校验,并在上下文缺失或格式错误时快速失败(fail-fast),同时要求输出脱敏,避免泄露租户、订阅和对象标识符。
集成上下文契约
技能定义了集成上下文契约,规范文件位于 docs/integration-context.md。工作流涉及的上下文字段包括:
- tenantId
- subscriptionId
- environmentCloud
- principalType
- scopesOrRoles
其中,Microsoft Intune 操作要求以下字段:
- tenantId:required(必需)
- subscriptionId:optional(可选)
- environmentCloud:AzureCloud*(适用时使用规范契约中的主权云取值)
- principalType:delegated-user 或 service-principal
- scopesOrRoles:DeviceManagementManagedDevices.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All、DeviceManagementApps.Read.All
当必需上下文缺失或格式错误时,应在发起 API 调用之前快速失败。输出需对租户、订阅和对象标识符进行脱敏。
主要能力(命令面)
技能提供以下命令,每个命令对应一个确定性工作流:
- intune-setup:用于 Intune 设置的确定性工作流。
- intune-noncompliant-devices:用于处理 Intune 不合规设备的确定性工作流。
- intune-lost-device-action:用于 Intune 丢失设备操作的确定性工作流。
- intune-compliance-policy-deploy:用于 Intune 合规策略部署的确定性工作流。
- intune-app-protection-review:用于 Intune 应用保护审查的确定性工作流。
使用方式与护栏
技能要求遵循以下护栏:
- 在任何 API 调用之前,校验上下文模式(context schema)与最小授权(minimum grants)。
- 尽可能优先执行只读发现(read-only discovery)。
- 对破坏性操作要求显式确认。
- 操作后重新查询并验证状态。
- 返回结构化、脱敏的输出。
参考文件
技能采用渐进式披露(Progressive Disclosure)方式提供参考文件:
- 端点与权限参考:references/api-reference.md
适用场景
适用于需要以确定性、可审计方式执行 Microsoft Intune 运维任务的场景,例如设备合规性检查、丢失设备操作、合规策略部署和应用保护审查。
限制
资料未提供该技能的具体安装命令、运行环境要求、支持的平台版本、收费或价格信息,以及实际执行效果,这些内容暂未提供。