EnterpriseModernAppManagement 云解决方案提供商

EnterpriseModernAppManagement 配置服务提供商 (CSP) 用于预配和报告新式企业应用。 有关如何使用此 CSP 来报告应用清单、安装和删除用户应用、将应用预配到设备以及管理应用许可证的详细信息,请参阅 企业应用管理

注意

Windows Holographic 仅支持 EnterpriseModernAppManagement CSP 的每用户配置。

以下列表显示了 EnterpriseModernAppManagement 配置服务提供程序节点:

Device/AppInstallation

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation

用于执行应用安装。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”

Device/AppInstallation/{PackageFamilyName}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}

包系列名称 (应用的 PFN) 。 报告清单时,设备上每个 PFN 都有一个。 这些项在其签名源下扎根。

这是一个可选节点。

注意

XAP 文件使用产品 ID 代替 PackageFamilyName。 下面是 XAP 产品 ID (包括大括号) 的示例。 {12345678-9012-3456-7890-123456789012}

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取、替换
动态节点命名 UniqueName:应用 (PFN) 的包系列名称。

示例

下面是卸载应用的示例:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
        <!-- Uninstall app -->
        <delete>
           <CmdID>2</CmdID>
              <Item>
                 <Target>
                    <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/%7b12345678-9012-3456-7890-123456789012%7D</LocURI>
                 </Target>
              </Item>
        </delete>
     <Final/>
  </SyncBody>
</SyncML>

Device/AppInstallation/{PackageFamilyName}/HostedInstall

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/HostedInstall

用于从托管位置执行应用包安装的命令, (这可以是本地驱动器、UNC 或 https 数据源) 。

这是一个必需的节点。 以下列表显示了支持的部署选项:

  • ForceApplicationShutdown
  • DevelopmentMode
  • InstallAllResources
  • ForceTargetApplicationShutdown
  • ForceUpdateToAnyVersion
  • DeferRegistration=“1”。 如果在安装时应用正在使用。 此选项暂存应用更新的文件,并在应用关闭后完成应用更新的注册。 在 20H1 的最新预览体验版中可用。
  • StageOnly=“1”。 暂存应用安装或更新文件,而不安装应用。 在 1803 中可用。
  • LicenseUri=“\server\license.lic”。 从 适用于企业的 Microsoft Store部署脱机许可证。 在 1607 中可用。
  • ValidateDependencies=“1”。 此选项在预配/暂存时使用。 如果它设置为 1,则部署将在过渡期间执行我们通常在注册时执行的相同依赖项验证,如果不存在依赖项,则会失败并拒绝预配请求。 在 20H1 的最新预览体验版中可用。
  • ExcludeAppFromLayoutModification=“1”。 设置应用将在所有设备上预配,并且能够保留预配的应用,而无需固定它们以开始布局。 1809 年可用。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Add、Delete、Exec、Get

Device/AppInstallation/{PackageFamilyName}/LastError

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/LastError

与应用安装相关的最后一个错误。

注意

安装应用后,此元素不存在。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”

Device/AppInstallation/{PackageFamilyName}/LastErrorDesc

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/LastErrorDesc

与应用安装相关的上一个错误的说明。

注意

安装应用后,此元素不存在。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”

Device/AppInstallation/{PackageFamilyName}/ProgressStatus

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/ProgressStatus

一个整数,指示应用安装进度。 对于 https 位置,这指示下载进度。 ProgressStatus 不可用于预配,它仅适用于基于用户的安装。 在预配中,该值始终为 0 (零) 。

注意

安装应用后,此元素不存在。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”

Device/AppInstallation/{PackageFamilyName}/Status

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/Status

应用安装的状态。 返回以下值:NOT_INSTALLED (0) - 已添加节点,但尚未完成执行。 安装 (1) - 执行已开始,但部署尚未完成。 如果部署完成而不考虑成功,则此值将更新。 失败 (2) - 安装失败。 错误的详细信息可以在 LastError 和 LastErrorDescription 下找到。 安装 (3) - 安装成功后,此节点将被清理,但如果清理操作尚未完成,则可能会短暂显示此状态。

注意

安装应用后,此元素不存在。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”

Device/AppInstallation/{PackageFamilyName}/StoreInstall

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/StoreInstall

用于从 Microsoft Store 执行应用和许可证安装的命令。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Add、Delete、Exec、Get

Device/AppLicenses

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses

用于管理应用方案的许可证。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”

Device/AppLicenses/StoreLicenses

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses

用于管理应用商店应用的许可证。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”

Device/AppLicenses/StoreLicenses/{LicenseID}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}

应用商店已安装应用的许可证 ID。 许可证 ID 通常是应用的 PFN。

这是一个可选节点。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 UniqueName:应用商店已安装应用的许可证 ID。 许可证 ID 通常是应用的 PFN。
Device/AppLicenses/StoreLicenses/{LicenseID}/AddLicense
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/AddLicense

用于添加许可证的命令。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Exec
Device/AppLicenses/StoreLicenses/{LicenseID}/GetLicenseFromStore
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/GetLicenseFromStore

用于从应用商店获取许可证的命令。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Exec
Device/AppLicenses/StoreLicenses/{LicenseID}/LicenseCategory
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/LicenseCategory

用于对各种许可证源进行分类的许可证类别。 有效值:未知 - 未知许可证类别。 零售 - 通过零售渠道(通常从 Microsoft Store)销售的许可证。 企业 - 通过企业销售渠道(通常从适用于企业的应用商店)销售的许可证。 OEM - 颁发给 OEM 的许可证。 开发人员 - 开发人员许可证,通常在应用开发或旁加载方案中安装。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppLicenses/StoreLicenses/{LicenseID}/LicenseUsage
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/LicenseUsage

指示许可证的允许用法。 有效值:未知 - 使用情况未知。 联机 - 许可证仅对联机使用有效。 这适用于具有并发要求的应用程序,例如在多台计算机上使用的应用,但只能在任何给定时间在一台计算机上使用。 脱机 - 许可证对脱机使用有效。 无需连接到 Internet 就可以使用此许可证。 企业根 - 许可证对业务线应用有效。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppLicenses/StoreLicenses/{LicenseID}/RequesterID
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/RequesterID

请求许可证的实体的标识符,例如获取许可证的客户端。 例如,Microsoft Store for Business 为特定企业客户端颁发的所有许可证具有相同的 RequesterID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”

Device/AppManagement

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement

用于清单和应用管理 (安装后) 。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”

Device/AppManagement/AppInventoryQuery

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryQuery

指定应用清单查询。

这是一个必需的节点。 查询参数:

  • 输出 - 指定 AppInventoryResults 操作中返回的信息的参数。 多个值必须用 |分隔。 有效值包括:

    • PackagesName - 返回应用的 PackageFamilyNamePackageFullName 。 如果未指定任何内容,则为默认值。
      • PackageDetails - 返回包的所有清单属性。 此信息包括 PackageNames 参数中的所有信息,但不会验证 RequiresReinstall。
      • RequiredReinstall - 验证清单查询中应用的应用状态,以确定它们是否需要重新安装。 此属性可能会影响系统性能,具体取决于安装的应用数。 当资源包更新或应用处于篡改状态时,会要求重新安装。
  • 源 - 指定与现有清单节点一致的应用分类。 可以使用特定筛选器,如果未指定筛选器,则将返回所有源。 如果未指定值,则返回所有分类。 有效值包括:

    • AppStore - 此分类适用于从 Microsoft Store 获取的应用。 这些是直接从 Microsoft Store 安装的应用或从 适用于企业的 Microsoft Store 安装的企业应用。
    • nonStore - 此分类适用于未从 Microsoft Store 获取的应用。
    • 系统 - 属于 OS 的应用。 无法卸载这些应用。 此分类是只读的,只能列出清单。
  • PackageTypeFilter - 指定可用于查询用户或设备的一个或多个包类型。 多个值必须用 |分隔。 有效值包括:

    • Main - 返回已安装main包。
    • 捆绑包 - 返回已安装的捆绑包。
    • 框架 - 返回已安装的框架包。
    • 资源 - 返回已安装的资源包。 资源是语言、缩放或 DirectX 资源。 它们是捆绑包的一部分。
    • XAP - 返回 XAP 包类型。 此筛选器仅在 Windows 移动版上受支持。
    • All - 返回所有包类型。

    如果未指定值,则返回 Main、Bundle 和 Framework 的组合。

  • PackageFamilyName - 指定特定包的名称。 如果指定此参数,它将返回包系列名称(如果包包含此值)。

    如果未指定此值,则返回所有包。

  • Publisher - 指定特定包的发布者。 如果指定此参数,如果“发布服务器”字段中存在该值,它将返回发布服务器。

    如果未指定此值,则返回所有发布者。

描述框架属性:

属性名 属性值
格式 xml
访问类型 获取、替换

示例

以下示例设置包名称的清单查询,并检查非存储应用的所有main包的重新安装状态。

<Replace>
   <CmdID>10</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryQuery</LocURI>
      </Target>
      <Meta><Format xmlns="syncml:metinf">xml</Format></Meta>
      <Data><Inventory Output="PackageNames|RequiresReinstall" Source="nonStore" PackageTypeFilter="Main" /></Data>
   </Item>
</Replace>

Device/AppManagement/AppInventoryResults

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryResults

返回在 AppInventoryQuery 操作后创建的应用清单的结果。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 xml
访问类型 “获取”

示例

下面是 AppInventoryResults 操作的示例。

<Get>
   <CmdID>11</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryResults</LocURI>
      </Target>
   </Item>
</Get>

Device/AppManagement/AppStore

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore

这是一个必需的节点。 用于管理 Microsoft Store 中的应用。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取

Device/AppManagement/AppStore/{PackageFamilyName}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}

包系列名称 (应用的 PFN) 。 报告清单时,设备上每个 PFN 都有一个。 这些项在其签名源下扎根。

注意

XAP 文件使用产品 ID 代替 PackageFamilyName。 下面是 XAP 产品 ID (包括大括号) 的示例。 {12345678-9012-3456-7890-123456789012}

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory

示例

下面是卸载应用的示例:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
        <!-- Uninstall app -->
        <delete>
           <CmdID>2</CmdID>
              <Item>
                 <Target>
                    <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/%7b12345678-9012-3456-7890-123456789012%7D</LocURI>
                 </Target>
              </Item>
        </delete>
     <Final/>
  </SyncBody>
</SyncML>
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}

已安装的包的全名。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Architecture
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Architecture

已安装包的体系结构。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/InstallDate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/InstallDate

应用的安装日期。 值类型为字符串。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/InstallLocation
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/InstallLocation

在设备上安装应用的位置。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsBundle
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsBundle

如果包是应用捆绑包,则值为 1,对于所有其他情况,则值为 0 (零) 。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsFramework
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsFramework

应用是否为框架包。 值类型为 int。如果应用是框架包,则值为 1,对于所有其他情况,则值为 0 (零) 。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsProvisioned
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsProvisioned

值为 0 或 1,指示是否在设备上预配了应用。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsStub
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsStub

此节点用于标识包是否为存根包。 存根包是包的版本,其功能最小,可减小应用的大小。

如果包是存根包,则值为 1,对于所有其他情况,值为 0 (零) 。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Name
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Name

应用的名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/PackageStatus
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/PackageStatus

提供有关包状态的信息。 值类型为 int。有效值为:正常 (0) - 包可用。 LicenseIssue (1) - 包的许可证无效。 修改 (2) - 未知源修改了包有效负载。 篡改 (4) - 包有效负载被故意篡改。 禁用 (8) - 包不可用。 仍可对其进行服务。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Publisher
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Publisher

应用的发布者名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/RequiresReinstall
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/RequiresReinstall

指定包状态是否已更改,并且需要重新安装应用。 当需要新的应用资源时(例如,当设备的语言首选项或新的 DPI 发生更改时),可能会发生这种情况。 包损坏也可能发生这种情况。 如果值为 1,则执行应用重新安装。

这是一个必需的节点。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/ResourceID
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/ResourceID

应用的资源 ID。 对于 main 应用,对于捆绑包,此为 null,并且包含资源包的资源信息。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Users
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Users

应用的注册用户和包安装状态。 如果查询位于设备级别,则返回设备的所有已注册用户。 如果查询用户上下文,它将仅返回当前用户。

这是一个必需的节点。 可能值:

  • 0 = 未安装
  • 1 = 分阶段
  • 2 = 已安装
  • 6 = 已暂停

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Version
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Version

应用版本。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/{PackageFamilyName}/DoNotUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/DoNotUpdate

指定是否要阻止特定应用通过自动更新进行更新。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。
Device/AppManagement/AppStore/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate

指定在 AMD64 设备上,在应用更新中,已安装应用的体系结构是否不得更改。 例如,如果你安装了 Windows 应用的 x86 风格,并且启用了此设置,则在整个更新中,即使 x64 风格可用,也会安装 x86 风格。

AMD64 计算机上的预期行为,该计算机安装了具有 x86 风格的应用 (最严格的胜) 。

适用性设置 CSP 状态 结果
True 未配置 已选取 X86 风格
True 启用 已选取 X86 风格
True 禁用 已选取 X86 风格
未) 设置假 ( 未配置 选取 X64 风格

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。
Device/AppManagement/AppStore/{PackageFamilyName}/NonRemovable
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10 版本 1809 [10.0.17763] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/NonRemovable

此设置允许 IT 管理员将应用设置为不可移动或用户无法卸载。 这在企业和教育方案中非常有用,其中 IT 管理员可能希望确保每个人都始终拥有特定的应用,并且不会意外删除它们。 如果每台设备有多个用户,并且你希望确保一个用户不会删除所有用户的用户,这也很有用。

NonRemovable 需要管理员权限。 此设置只能按设备定义,不能按用户定义。 可以使用 AppInventoryQuery 或 AppInventoryResults 查询设置。

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、获取、替换

允许的值:

描述
0 应用不在不可移动的应用策略列表中。
1 应用包含在不可移动的应用策略列表中。

示例

  • 将应用添加到不可移动的应用策略列表

    <SyncML xmlns="SYNCML:SYNCML1.2">
        <SyncBody>
           <Add>
                 <CmdID>1</CmdID>
                 <Item>
                    <Target>
                       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                    </Target>
                    <Meta>
                       <Format xmlns="syncml:metinf">int</Format>
                    </Meta>
                    <Data>1</Data>
                 </Item>
           </Add>
           <Final/>
           </SyncBody>
    </SyncML>
    
  • 获取特定应用的状态

    <SyncML xmlns="SYNCML:SYNCML1.2">
        <SyncBody>
           <Get>
                 <CmdID>1</CmdID>
                 <Item>
                    <Target>
                       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                    </Target>
                 </Item>
           </Get>
           <Final/>
          </SyncBody>
      </SyncML>
    
  • 替换不可移动应用策略列表中的应用, (Data 0 = 应用不在应用策略列表中;数据 1 = 应用在应用策略列表中)

    <SyncML xmlns="SYNCML:SYNCML1.2">
        <SyncBody>
           <Replace>
                 <CmdID>1</CmdID>
                 <Item>
                    <Target>
                       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                    </Target>
                    <Meta>
                       <Format xmlns="syncml:metinf">int</Format>
                    </Meta>
                    <Data>0</Data>
                 </Item>
           </Replace>
           <Final/>
        </SyncBody>
    </SyncML>
    

Device/AppManagement/AppStore/ReleaseManagement

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement

通过 Microsoft Store 管理更新的内部节点。 这些设置允许 IT 管理员为希望用户用于接收更新的应用指定更新通道。 它允许 IT 管理员将特定版本分配给较小的组,以便在将大型部署之前部署到组织的其余部分进行测试。

注意

ReleaseManagement 设置仅适用于通过 Microsoft Store 进行的更新。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
Device/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}

应用或应用集的标识符。 如果只有一个应用,则为 PackageFamilyName。 如果它适用于一组应用,则为 main 应用的 PackageFamilyName。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
动态节点命名 UniqueName:如果只有一个应用,则名称为 PackageFamilyName。 如果它适用于一组应用,则名称为main应用的 PackageFamilyName。
Device/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/ChannelId

指定应用通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换
Device/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease

内部节点用于指定在设备上设置多个用户策略时要使用的有效应用版本。 使用设备策略或上次用户策略。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”
Device/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId

返回设备上的最后一个用户通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId

返回设备上最后一个用户版本 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId

IT 管理员可以指定发布 ID,以指示他们希望用户或设备处于打开的特定版本。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换

Device/AppManagement/LastScanError

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/LastScanError

报告更新扫描返回的最后一个错误代码。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”

Device/AppManagement/nonStore

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore

用于管理未从 Microsoft Store 获取的企业应用或开发人员应用。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取

Device/AppManagement/nonStore/{PackageFamilyName}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}

包系列名称 (应用的 PFN) 。 报告清单时,设备上每个 PFN 都有一个。 这些项在其签名源下扎根。

注意

XAP 文件使用产品 ID 代替 PackageFamilyName。 下面是 XAP 产品 ID (包括大括号) 的示例。 {12345678-9012-3456-7890-123456789012}

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory

示例

下面是卸载应用的示例:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
        <!-- Uninstall app -->
        <delete>
           <CmdID>2</CmdID>
              <Item>
                 <Target>
                    <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/%7b12345678-9012-3456-7890-123456789012%7D</LocURI>
                 </Target>
              </Item>
        </delete>
     <Final/>
  </SyncBody>
</SyncML>
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}

已安装的包的全名。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Architecture
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Architecture

已安装包的体系结构。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/InstallDate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/InstallDate

应用的安装日期。 值类型为字符串。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/InstallLocation
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/InstallLocation

在设备上安装应用的位置。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsBundle
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsBundle

如果包是应用捆绑包,则值为 1,对于所有其他情况,则值为 0 (零) 。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsFramework
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsFramework

应用是否为框架包。 值类型为 int。如果应用是框架包,则值为 1,对于所有其他情况,则值为 0 (零) 。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsProvisioned
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsProvisioned

值为 0 或 1,指示是否在设备上预配了应用。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsStub
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsStub

此节点用于标识包是否为存根包。 存根包是包的版本,其功能最小,可减小应用的大小。

如果包是存根包,则值为 1,对于所有其他情况,值为 0 (零) 。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Name
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Name

应用的名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/PackageStatus
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/PackageStatus

提供有关包状态的信息。 值类型为 int。有效值为:正常 (0) - 包可用。 LicenseIssue (1) - 包的许可证无效。 修改 (2) - 未知源修改了包有效负载。 篡改 (4) - 包有效负载被故意篡改。 禁用 (8) - 包不可用。 仍可对其进行服务。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Publisher
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Publisher

应用的发布者名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/RequiresReinstall
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/RequiresReinstall

指定包状态是否已更改,并且需要重新安装应用。 当需要新的应用资源时(例如,当设备的语言首选项或新的 DPI 发生更改时),可能会发生这种情况。 包损坏也可能发生这种情况。 如果值为 1,则执行应用重新安装。

这是一个必需的节点。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/ResourceID
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/ResourceID

应用的资源 ID。 对于 main 应用,对于捆绑包,此为 null,并且包含资源包的资源信息。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Users
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Users

应用的注册用户和包安装状态。 如果查询位于设备级别,则返回设备的所有已注册用户。 如果查询用户上下文,它将仅返回当前用户。

这是一个必需的节点。 可能值:

  • 0 = 未安装
  • 1 = 分阶段
  • 2 = 已安装
  • 6 = 已暂停

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Version
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Version

应用版本。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/{PackageFamilyName}/DoNotUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/DoNotUpdate

指定是否要阻止特定应用通过自动更新进行更新。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。
Device/AppManagement/nonStore/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate

指定在 AMD64 设备上,在应用更新中,已安装应用的体系结构是否不得更改。 例如,如果你安装了 Windows 应用的 x86 风格,并且启用了此设置,则在整个更新中,即使 x64 风格可用,也会安装 x86 风格。

AMD64 计算机上的预期行为,该计算机安装了具有 x86 风格的应用 (最严格的胜) 。

适用性设置 CSP 状态 结果
True 未配置 已选取 X86 风格
True 启用 已选取 X86 风格
True 禁用 已选取 X86 风格
未) 设置假 ( 未配置 选取 X64 风格

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。
Device/AppManagement/nonStore/{PackageFamilyName}/NonRemovable
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10 版本 1809 [10.0.17763] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/NonRemovable

此设置允许 IT 管理员将应用设置为不可移动或用户无法卸载。 这在企业和教育方案中非常有用,其中 IT 管理员可能希望确保每个人都始终拥有特定的应用,并且不会意外删除它们。 如果每台设备有多个用户,并且你希望确保一个用户不会删除所有用户的用户,这也很有用。

NonRemovable 需要管理员权限。 此设置只能按设备定义,不能按用户定义。 可以使用 AppInventoryQuery 或 AppInventoryResults 查询设置。

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、获取、替换

允许的值:

描述
0 应用不在不可移动的应用策略列表中。
1 应用包含在不可移动的应用策略列表中。

示例

  • 将应用添加到不可移动的应用策略列表

    <SyncML xmlns="SYNCML:SYNCML1.2">
        <SyncBody>
           <Add>
                 <CmdID>1</CmdID>
                 <Item>
                    <Target>
                       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                    </Target>
                    <Meta>
                       <Format xmlns="syncml:metinf">int</Format>
                    </Meta>
                    <Data>1</Data>
                 </Item>
           </Add>
           <Final/>
           </SyncBody>
    </SyncML>
    
  • 获取特定应用的状态

    <SyncML xmlns="SYNCML:SYNCML1.2">
        <SyncBody>
           <Get>
              <CmdID>1</CmdID>
              <Item>
                    <Target>
                       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                    </Target>
              </Item>
           </Get>
           <Final/>
        </SyncBody>
    </SyncML>
    
  • 替换不可移动应用策略列表中的应用, (Data 0 = 应用不在应用策略列表中;数据 1 = 应用在应用策略列表中)

    <SyncML xmlns="SYNCML:SYNCML1.2">
        <SyncBody>
           <Replace>
                 <CmdID>1</CmdID>
                 <Item>
                    <Target>
                       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                    </Target>
                    <Meta>
                       <Format xmlns="syncml:metinf">int</Format>
                    </Meta>
                    <Data>0</Data>
                 </Item>
           </Replace>
           <Final/>
        </SyncBody>
    </SyncML>
    

Device/AppManagement/nonStore/ReleaseManagement

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement

通过 Microsoft Store 管理更新的内部节点。 这些设置允许 IT 管理员为希望用户用于接收更新的应用指定更新通道。 它允许 IT 管理员将特定版本分配给较小的组,以便在将大型部署之前部署到组织的其余部分进行测试。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
Device/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}

应用或应用集的标识符。 如果只有一个应用,则为 PackageFamilyName。 如果它适用于一组应用,则为 main 应用的 PackageFamilyName。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
动态节点命名 UniqueName:如果只有一个应用,则名称为 PackageFamilyName。 如果它适用于一组应用,则名称为main应用的 PackageFamilyName。
Device/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/ChannelId

指定应用通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换
Device/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease

内部节点用于指定在设备上设置多个用户策略时要使用的有效应用版本。 使用设备策略或上次用户策略。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”
Device/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId

返回设备上的最后一个用户通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId

返回设备上最后一个用户版本 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId

IT 管理员可以指定发布 ID,以指示他们希望用户或设备处于打开的特定版本。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换

Device/AppManagement/ResetPackage

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/ResetPackage

用于将 Windows 应用还原到其初始配置。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Exec、Get

Device/AppManagement/System

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System

报告作为操作系统的一部分安装的应用。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取

Device/AppManagement/System/{PackageFamilyName}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}

包系列名称 (应用的 PFN) 。 报告清单时,设备上每个 PFN 都有一个。 这些项在其签名源下扎根。

注意

XAP 文件使用产品 ID 代替 PackageFamilyName。 下面是 XAP 产品 ID (包括大括号) 的示例。 {12345678-9012-3456-7890-123456789012}

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}

已安装的包的全名。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Architecture
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Architecture

已安装包的体系结构。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/InstallDate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/InstallDate

应用的安装日期。 值类型为字符串。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/InstallLocation
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/InstallLocation

在设备上安装应用的位置。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsBundle
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsBundle

如果包是应用捆绑包,则值为 1,对于所有其他情况,则值为 0 (零) 。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsFramework
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsFramework

应用是否为框架包。 值类型为 int。如果应用是框架包,则值为 1,对于所有其他情况,则值为 0 (零) 。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsProvisioned
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsProvisioned

值为 0 或 1,指示是否在设备上预配了应用。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsStub
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsStub

此节点用于标识包是否为存根包。 存根包是包的版本,其功能最小,可减小应用的大小。

如果包是存根包,则值为 1,对于所有其他情况,值为 0 (零) 。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Name
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Name

应用的名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/PackageStatus
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/PackageStatus

提供有关包状态的信息。 值类型为 int。有效值为:正常 (0) - 包可用。 LicenseIssue (1) - 包的许可证无效。 修改 (2) - 未知源修改了包有效负载。 篡改 (4) - 包有效负载被故意篡改。 禁用 (8) - 包不可用。 仍可对其进行服务。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Publisher
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Publisher

应用的发布者名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/RequiresReinstall
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/RequiresReinstall

指定包状态是否已更改,并且需要重新安装应用。 当需要新的应用资源时(例如,当设备的语言首选项或新的 DPI 发生更改时),可能会发生这种情况。 包损坏也可能发生这种情况。 如果值为 1,则执行应用重新安装。

这是一个必需的节点。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/ResourceID
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/ResourceID

应用的资源 ID。 对于 main 应用,对于捆绑包,此为 null,并且包含资源包的资源信息。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Users
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Users

应用的注册用户和包安装状态。 如果查询位于设备级别,则返回设备的所有已注册用户。 如果查询用户上下文,它将仅返回当前用户。

这是一个必需的节点。

  • 0 = 未安装
  • 1 = 分阶段
  • 2 = 已安装
  • 6 = 已暂停

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Version
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Version

应用版本。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings

AppUpdateSettings 节点,支持特定包的自动更新和自动修复功能。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoRepair
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoRepair

自动修复节点,支持特定包的自动修复功能。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoRepair/PackageSource
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoRepair/PackageSource

指向特定包的更新位置的 PackageSource 节点。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 获取、替换
允许的值 正则表达式: ^(([^;]+(?i)(\.appx|\.eappx|\.appxbundle|\.eappxbundle|\.msix|\.emsix|\.msixbundle|\.emsixbundle)([;]|$)){0,10}|([^;]+(?i)(\.appinstaller)([;]|$)){0,10})$
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings

AutoUpdateSettings 节点,支持特定包的自动更新。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/AutomaticBackgroundTask
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/AutomaticBackgroundTask

指定是否为特定包启用/禁用 AutomaticBackgroundTask。

描述框架属性:

属性名 属性值
格式 bool
访问类型 获取、替换
默认值 False

允许的值:

说明
True 为包启用了 AutomaticBackgroundTask。
错误 (默认) 对包禁用 AutomaticBackgroundTask。
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/Disable
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/Disable

指定是否为特定包启用/禁用自动更新设置。

描述框架属性:

属性名 属性值
格式 bool
访问类型 获取、替换
默认值 False

允许的值:

说明
True 对包禁用“自动更新”设置。
错误 (默认) 为包启用“自动更新”设置。
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/ForceUpdateFromAnyVersion
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/ForceUpdateFromAnyVersion

指定是否为特定包启用/禁用 ForceUpdateFromAnyVersion 自动更新设置。

描述框架属性:

属性名 属性值
格式 bool
访问类型 获取、替换
默认值 False

允许的值:

说明
True 为包启用了 ForceUpdateFromAnyVersion。
错误 (默认) 对包禁用 ForceUpdateFromAnyVersion。
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/HoursBetweenUpdateChecks
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/HoursBetweenUpdateChecks

为特定包指定 HoursBetweenUpdateChecks。

描述框架属性:

属性名 属性值
格式 int
访问类型 获取、替换
允许的值 范围: [8-10000]
默认值 8
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/OnLaunchUpdateCheck
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/OnLaunchUpdateCheck

指定是否为特定包启用/禁用 OnLaunchUpdateCheck。

描述框架属性:

属性名 属性值
格式 bool
访问类型 获取、替换
默认值 False

允许的值:

说明
True 为包启用了 OnLaunchUpdateCheck。
错误 (默认) 对包禁用 OnLaunchUpdateCheck。
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/PackageSource
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/PackageSource

指向特定包的更新位置的 PackageSource 节点。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 获取、替换
允许的值 正则表达式: ^(([^;]+(?i)(\.appinstaller)([;]|$)){1,11})$
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/ShowPrompt
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/ShowPrompt

指定是否为特定包启用/禁用 ShowPrompt 自动更新设置。

描述框架属性:

属性名 属性值
格式 bool
访问类型 获取、替换
默认值 False

允许的值:

说明
True 为包启用了 ShowPrompt。
错误 (默认) 对包禁用了 ShowPrompt。
Device/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/UpdateBlocksActivation
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppUpdateSettings/AutoUpdateSettings/UpdateBlocksActivation

指定是否为特定包启用/禁用自动更新设置 UpdateBlocksActivation。

描述框架属性:

属性名 属性值
格式 bool
访问类型 获取、替换
默认值 False

允许的值:

说明
True 为包启用了 UpdateBlocksActivation。
错误 (默认) 对包禁用 UpdateBlocksActivation。
Device/AppManagement/System/{PackageFamilyName}/DoNotUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/DoNotUpdate

指定是否要阻止特定应用通过自动更新进行更新。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。
Device/AppManagement/System/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate

指定在 AMD64 设备上,在应用更新中,已安装应用的体系结构是否不得更改。 例如,如果你安装了 Windows 应用的 x86 风格,并且启用了此设置,则在整个更新中,即使 x64 风格可用,也会安装 x86 风格。

AMD64 计算机上的预期行为,该计算机安装了具有 x86 风格的应用 (最严格的胜) 。

适用性设置 CSP 状态 结果
True 未配置 已选取 X86 风格
True 启用 已选取 X86 风格
True 禁用 已选取 X86 风格
未) 设置假 ( 未配置 选取 X64 风格

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。
Device/AppManagement/System/{PackageFamilyName}/NonRemovable
范围 版本 适用的操作系统
✅ 设备
❌ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10 版本 1809 [10.0.17763] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/NonRemovable

此设置允许 IT 管理员将应用设置为不可移动或用户无法卸载。 这在企业和教育方案中非常有用,其中 IT 管理员可能希望确保每个人都始终拥有特定的应用,并且不会意外删除它们。 如果每台设备有多个用户,并且你希望确保一个用户不会删除所有用户的用户,这也很有用。

NonRemovable 需要管理员权限。 此设置只能按设备定义,不能按用户定义。 可以使用 AppInventoryQuery 或 AppInventoryResults 查询设置。

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、获取、替换

允许的值:

描述
0 应用不在不可移动的应用策略列表中。
1 应用包含在不可移动的应用策略列表中。

示例

  • 将应用添加到不可移动的应用策略列表

    <SyncML xmlns="SYNCML:SYNCML1.2">
        <SyncBody>
           <Add>
                 <CmdID>1</CmdID>
                 <Item>
                    <Target>
                       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                    </Target>
                    <Meta>
                       <Format xmlns="syncml:metinf">int</Format>
                    </Meta>
                    <Data>1</Data>
                 </Item>
           </Add>
           <Final/>
           </SyncBody>
    </SyncML>
    
  • 获取特定应用的状态

    <SyncML xmlns="SYNCML:SYNCML1.2">
        <SyncBody>
           <Get>
                 <CmdID>1</CmdID>
                 <Item>
                    <Target>
                       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                    </Target>
                 </Item>
           </Get>
           <Final/>
        </SyncBody>
    </SyncML>
    
  • 替换不可移动应用策略列表中的应用, (Data 0 = 应用不在应用策略列表中;数据 1 = 应用在应用策略列表中)

    <SyncML xmlns="SYNCML:SYNCML1.2">
        <SyncBody>
           <Replace>
                 <CmdID>1</CmdID>
                 <Item>
                    <Target>
                       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/NonRemovable</LocURI>
                    </Target>
                    <Meta>
                       <Format xmlns="syncml:metinf">int</Format>
                    </Meta>
                    <Data>0</Data>
                 </Item>
           </Replace>
           <Final/>
        </SyncBody>
    </SyncML>
    

Device/AppManagement/System/ReleaseManagement

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement

通过 Microsoft Store 管理更新的内部节点。 这些设置允许 IT 管理员为希望用户用于接收更新的应用指定更新通道。 它允许 IT 管理员将特定版本分配给较小的组,以便在将大型部署之前部署到组织的其余部分进行测试。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
Device/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}

应用或应用集的标识符。 如果只有一个应用,则为 PackageFamilyName。 如果它适用于一组应用,则为 main 应用的 PackageFamilyName。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
动态节点命名 UniqueName:如果只有一个应用,则名称为 PackageFamilyName。 如果它适用于一组应用,则名称为main应用的 PackageFamilyName。
Device/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/ChannelId

指定应用通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换
Device/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease

内部节点用于指定在设备上设置多个用户策略时要使用的有效应用版本。 使用设备策略或上次用户策略。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”
Device/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId

返回设备上的最后一个用户通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId

返回设备上最后一个用户版本 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
Device/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId

IT 管理员可以指定发布 ID,以指示他们希望用户或设备处于打开的特定版本。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换

Device/AppManagement/UpdateScan

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/UpdateScan

用于启动Windows 更新扫描。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 null
访问类型 Exec

User/AppInstallation

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation

用于执行应用安装。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”

User/AppInstallation/{PackageFamilyName}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}

包系列名称 (应用的 PFN) 。 报告清单时,设备上每个 PFN 都有一个。 这些项在其签名源下扎根。

注意

XAP 文件使用产品 ID 代替 PackageFamilyName。 下面是 XAP 产品 ID (包括大括号) 的示例。 {12345678-9012-3456-7890-123456789012}

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取、替换
动态节点命名 UniqueName:应用 (PFN) 的包系列名称。

示例

下面是卸载应用的示例:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
        <!-- Uninstall app -->
        <delete>
           <CmdID>2</CmdID>
              <Item>
                 <Target>
                    <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/%7b12345678-9012-3456-7890-123456789012%7D</LocURI>
                 </Target>
              </Item>
        </delete>
     <Final/>
  </SyncBody>
</SyncML>

User/AppInstallation/{PackageFamilyName}/HostedInstall

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/HostedInstall

用于从托管位置执行应用包安装的命令, (这可以是本地驱动器、UNC 或 https 数据源) 。

这是一个必需的节点。 以下列表显示了支持的部署选项:

  • ForceApplicationShutdown
  • DevelopmentMode
  • InstallAllResources
  • ForceTargetApplicationShutdown
  • ForceUpdateToAnyVersion
  • DeferRegistration=“1”。 如果在安装时应用正在使用。 此选项暂存应用更新的文件,并在应用关闭后完成应用更新的注册。 在 20H1 的最新预览体验版中可用。
  • StageOnly=“1”。 暂存应用安装或更新文件,而不安装应用。 在 1803 中可用。
  • LicenseUri=“\server\license.lic”。 从 适用于企业的 Microsoft Store部署脱机许可证。 在 1607 中可用。
  • ValidateDependencies=“1”。 此选项在预配/暂存时使用。 如果它设置为 1,则部署将在过渡期间执行我们通常在注册时执行的相同依赖项验证,如果不存在依赖项,则会失败并拒绝预配请求。 在 20H1 的最新预览体验版中可用。
  • ExcludeAppFromLayoutModification=“1”。 设置应用将在所有设备上预配,并且能够保留预配的应用,而无需固定它们以开始布局。 1809 年可用。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Add、Delete、Exec、Get

User/AppInstallation/{PackageFamilyName}/LastError

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/LastError

与应用安装相关的最后一个错误。

注意

安装应用后,此元素不存在。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”

User/AppInstallation/{PackageFamilyName}/LastErrorDesc

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/LastErrorDesc

与应用安装相关的上一个错误的说明。

注意

安装应用后,此元素不存在。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”

User/AppInstallation/{PackageFamilyName}/ProgressStatus

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/ProgressStatus

一个整数,指示应用安装进度。 对于 https 位置,这指示下载进度。 ProgressStatus 不可用于预配,它仅适用于基于用户的安装。 在预配中,该值始终为 0 (零) 。

注意

安装应用后,此元素不存在。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”

User/AppInstallation/{PackageFamilyName}/Status

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/Status

应用安装的状态。 返回以下值:NOT_INSTALLED (0) - 已添加节点,但尚未完成执行。 安装 (1) - 执行已开始,但部署尚未完成。 如果部署完成而不考虑成功,则此值将更新。 失败 (2) - 安装失败。 错误的详细信息可以在 LastError 和 LastErrorDescription 下找到。 安装 (3) - 安装成功后,此节点将被清理,但如果清理操作尚未完成,则可能会短暂显示此状态。

注意

安装应用后,此元素不存在。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”

User/AppInstallation/{PackageFamilyName}/StoreInstall

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppInstallation/{PackageFamilyName}/StoreInstall

用于从 Microsoft Store 执行应用和许可证安装的命令。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Add、Delete、Exec、Get

User/AppLicenses

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses

用于管理应用方案的许可证。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”

User/AppLicenses/StoreLicenses

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses

用于管理应用商店应用的许可证。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”

User/AppLicenses/StoreLicenses/{LicenseID}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}

应用商店已安装应用的许可证 ID。 许可证 ID 通常是应用的 PFN。

这是一个可选节点。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 UniqueName:应用商店已安装应用的许可证 ID。 许可证 ID 通常是应用的 PFN。
User/AppLicenses/StoreLicenses/{LicenseID}/AddLicense
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/AddLicense

用于添加许可证的命令。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Exec
User/AppLicenses/StoreLicenses/{LicenseID}/GetLicenseFromStore
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/GetLicenseFromStore

用于从应用商店获取许可证的命令。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Exec
User/AppLicenses/StoreLicenses/{LicenseID}/LicenseCategory
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/LicenseCategory

用于对各种许可证源进行分类的许可证类别。 有效值:未知 - 未知许可证类别。 零售 - 通过零售渠道(通常从 Microsoft Store)销售的许可证。 企业 - 通过企业销售渠道(通常从适用于企业的应用商店)销售的许可证。 OEM - 颁发给 OEM 的许可证。 开发人员 - 开发人员许可证,通常在应用开发或旁加载方案中安装。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppLicenses/StoreLicenses/{LicenseID}/LicenseUsage
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/LicenseUsage

指示许可证的允许用法。 有效值:未知 - 使用情况未知。 联机 - 许可证仅对联机使用有效。 这适用于具有并发要求的应用程序,例如在多台计算机上使用的应用,但只能在任何给定时间在一台计算机上使用。 脱机 - 许可证对脱机使用有效。 无需连接到 Internet 就可以使用此许可证。 企业根 - 许可证对业务线应用有效。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppLicenses/StoreLicenses/{LicenseID}/RequesterID
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses/{LicenseID}/RequesterID

请求许可证的实体的标识符,例如获取许可证的客户端。 例如,Microsoft Store for Business 为特定企业客户端颁发的所有许可证具有相同的 RequesterID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”

User/AppManagement

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement

用于清单和应用管理 (安装后) 。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”

User/AppManagement/AppInventoryQuery

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryQuery

指定应用清单查询。

这是一个必需的节点。 查询参数:

  • 输出 - 指定 AppInventoryResults 操作中返回的信息的参数。 多个值必须用 |分隔。 有效值包括:

    • PackagesName - 返回应用的 PackageFamilyNamePackageFullName 。 如果未指定任何内容,则为默认值。
    • PackageDetails - 返回包的所有清单属性。 此信息包括 PackageNames 参数中的所有信息,但不会验证 RequiresReinstall。
    • RequiredReinstall - 验证清单查询中应用的应用状态,以确定它们是否需要重新安装。 此属性可能会影响系统性能,具体取决于安装的应用数。 当资源包更新或应用处于篡改状态时,会要求重新安装。
  • 源 - 指定与现有清单节点一致的应用分类。 可以使用特定筛选器,如果未指定筛选器,则将返回所有源。 如果未指定值,则返回所有分类。 有效值包括:

    • AppStore - 此分类适用于从 Microsoft Store 获取的应用。 这些是直接从 Microsoft Store 安装的应用或从 适用于企业的 Microsoft Store 安装的企业应用。
    • nonStore - 此分类适用于未从 Microsoft Store 获取的应用。
    • 系统 - 属于 OS 的应用。 无法卸载这些应用。 此分类是只读的,只能列出清单。
  • PackageTypeFilter - 指定可用于查询用户或设备的一个或多个包类型。 多个值必须用 |分隔。 有效值包括:

    • Main - 返回已安装main包。
    • 捆绑包 - 返回已安装的捆绑包。
    • 框架 - 返回已安装的框架包。
    • 资源 - 返回已安装的资源包。 资源是语言、缩放或 DirectX 资源。 它们是捆绑包的一部分。
    • XAP - 返回 XAP 包类型。 此筛选器仅在 Windows 移动版上受支持。
    • All - 返回所有包类型。

    如果未指定值,则返回 Main、Bundle 和 Framework 的组合。

  • PackageFamilyName - 指定特定包的名称。 如果指定此参数,它将返回包系列名称(如果包包含此值)。

    如果未指定此值,则返回所有包。

  • Publisher - 指定特定包的发布者。 如果指定此参数,如果“发布服务器”字段中存在该值,它将返回发布服务器。

    如果未指定此值,则返回所有发布者。

描述框架属性:

属性名 属性值
格式 xml
访问类型 获取、替换

示例

以下示例设置包名称的清单查询,并检查非存储应用的所有main包的重新安装状态。

<Replace>
   <CmdID>10</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryQuery</LocURI>
      </Target>
      <Meta><Format xmlns="syncml:metinf">xml</Format></Meta>
      <Data><Inventory Output="PackageNames|RequiresReinstall" Source="nonStore" PackageTypeFilter="Main" /></Data>
   </Item>
</Replace>

User/AppManagement/AppInventoryResults

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryResults

返回在 AppInventoryQuery 操作后创建的应用清单的结果。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 xml
访问类型 “获取”

示例

下面是 AppInventoryResults 操作的示例。

<Get>
   <CmdID>11</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppInventoryResults</LocURI>
      </Target>
   </Item>
</Get>

User/AppManagement/AppStore

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore

这是一个必需的节点。 用于管理 Microsoft Store 中的应用。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取

User/AppManagement/AppStore/{PackageFamilyName}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}

包系列名称 (应用的 PFN) 。 报告清单时,设备上每个 PFN 都有一个。 这些项在其签名源下扎根。

注意

XAP 文件使用产品 ID 代替 PackageFamilyName。 下面是 XAP 产品 ID (包括大括号) 的示例。 {12345678-9012-3456-7890-123456789012}

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory

示例

下面是卸载应用的示例:

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
        <!-- Uninstall app -->
        <delete>
           <CmdID>2</CmdID>
              <Item>
                 <Target>
                    <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/%7b12345678-9012-3456-7890-123456789012%7D</LocURI>
                 </Target>
              </Item>
        </delete>
     <Final/>
  </SyncBody>
</SyncML>
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}

已安装的包的全名。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Architecture
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Architecture

已安装包的体系结构。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/InstallDate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/InstallDate

应用的安装日期。 值类型为字符串。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/InstallLocation
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/InstallLocation

在设备上安装应用的位置。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsBundle
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsBundle

如果包是应用捆绑包,则值为 1,对于所有其他情况,则值为 0 (零) 。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsFramework
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsFramework

应用是否为框架包。 值类型为 int。如果应用是框架包,则值为 1,对于所有其他情况,则值为 0 (零) 。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsProvisioned
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsProvisioned

值为 0 或 1,指示是否在设备上预配了应用。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsStub
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/IsStub

此节点用于标识包是否为存根包。 存根包是包的版本,其功能最小,可减小应用的大小。

如果包是存根包,则值为 1,对于所有其他情况,值为 0 (零) 。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Name
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Name

应用的名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/PackageStatus
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/PackageStatus

提供有关包状态的信息。 值类型为 int。有效值为:正常 (0) - 包可用。 LicenseIssue (1) - 包的许可证无效。 修改 (2) - 未知源修改了包有效负载。 篡改 (4) - 包有效负载被故意篡改。 禁用 (8) - 包不可用。 仍可对其进行服务。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Publisher
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Publisher

应用的发布者名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/RequiresReinstall
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/RequiresReinstall

指定包状态是否已更改,并且需要重新安装应用。 当需要新的应用资源时(例如,当设备的语言首选项或新的 DPI 发生更改时),可能会发生这种情况。 包损坏也可能发生这种情况。 如果值为 1,则执行应用重新安装。

这是一个必需的节点。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/ResourceID
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/ResourceID

应用的资源 ID。 对于 main 应用,对于捆绑包,此为 null,并且包含资源包的资源信息。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Users
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Users

应用的注册用户和包安装状态。 如果查询位于设备级别,则返回设备的所有已注册用户。 如果查询用户上下文,它将仅返回当前用户。

这是一个必需的节点。 可能值:

  • 0 = 未安装
  • 1 = 分阶段
  • 2 = 已安装
  • 6 = 已暂停

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Version
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/{PackageFullName}/Version

应用版本。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/{PackageFamilyName}/AppSettingPolicy
范围 版本 适用的操作系统
❌ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/AppSettingPolicy

所有托管应用设置值的内部节点。

注意

仅在用户上下文中支持此节点。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取、替换
User/AppManagement/AppStore/{PackageFamilyName}/AppSettingPolicy/{SettingValue}
范围 版本 适用的操作系统
❌ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/AppSettingPolicy/{SettingValue}

SettingValue 和数据表示要为应用配置的键值对。 节点表示键的名称,数据表示值。 可以在托管的 LocalSettings 中找到此值。 应用程序。 设置容器。

此设置仅适用于支持该功能的应用,并且仅在用户上下文中受支持。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换
动态节点命名 UniqueName:SettingValue 表示键值对中的键。 可以在 Managed.App.Settings 容器的 LocalSettings 中找到值。

示例

  • 以下示例设置“Server”的值

    <!— Configure app settings -->
    <Add>
        <CmdID>0</CmdID>
        <Item>
           <Target>
              <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy/Server</LocURI>
           </Target>
           <Meta>
              <Format xmlns="syncml:metinf">chr</Format>
           </Meta>
           <Data>server1.contoso.com</Data>
        </Item>
    </Add>
    
  • 以下示例获取特定应用的所有托管应用设置。

    <!—- Get app settings -->
    <Get>
        <CmdID>0</CmdID>
        <Item>
           <Target>
              <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy?list=StructData</LocURI>
           </Target>
        </Item>
    </Get>
    
User/AppManagement/AppStore/{PackageFamilyName}/DoNotUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/DoNotUpdate

指定是否要阻止特定应用通过自动更新进行更新。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。
User/AppManagement/AppStore/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate

指定在 AMD64 设备上,在应用更新中,已安装应用的体系结构是否不得更改。 例如,如果你安装了 Windows 应用的 x86 风格,并且启用了此设置,则在整个更新中,即使 x64 风格可用,也会安装 x86 风格。

AMD64 计算机上的预期行为,该计算机安装了具有 x86 风格的应用 (最严格的胜) 。

适用性设置 CSP 状态 结果
True 未配置 已选取 X86 风格
True 已启用 已选取 X86 风格
True 禁用 已选取 X86 风格
未) 设置假 ( 未配置 选取 X64 风格

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。

User/AppManagement/AppStore/ReleaseManagement

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement

通过 Microsoft Store 管理更新的内部节点。 这些设置允许 IT 管理员为希望用户用于接收更新的应用指定更新通道。 它允许 IT 管理员将特定版本分配给较小的组,以便在将大型部署之前部署到组织的其余部分进行测试。

注意

ReleaseManagement 设置仅适用于通过 Microsoft Store 进行的更新。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
User/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}

应用或应用集的标识符。 如果只有一个应用,则为 PackageFamilyName。 如果它适用于一组应用,则为 main 应用的 PackageFamilyName。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
动态节点命名 UniqueName:如果只有一个应用,则名称为 PackageFamilyName。 如果它适用于一组应用,则名称为main应用的 PackageFamilyName。
User/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/ChannelId

指定应用通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换
User/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease

内部节点用于指定在设备上设置多个用户策略时要使用的有效应用版本。 使用设备策略或上次用户策略。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”
User/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId

返回设备上的最后一个用户通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId

返回设备上最后一个用户版本 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId

IT 管理员可以指定发布 ID,以指示他们希望用户或设备处于打开的特定版本。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换

User/AppManagement/LastScanError

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/LastScanError

报告更新扫描返回的最后一个错误代码。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”

User/AppManagement/nonStore

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore

用于管理未从 Microsoft Store 获取的企业应用或开发人员应用。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取

User/AppManagement/nonStore/{PackageFamilyName}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}

包系列名称 (应用的 PFN) 。 报告清单时,设备上每个 PFN 都有一个。 这些项在其签名源下扎根。

注意

XAP 文件使用产品 ID 代替 PackageFamilyName。 下面是 XAP 产品 ID (包括大括号) 的示例。 {12345678-9012-3456-7890-123456789012}

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory
<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
        <!-- Uninstall app -->
        <delete>
           <CmdID>2</CmdID>
              <Item>
                 <Target>
                    <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/%7b12345678-9012-3456-7890-123456789012%7D</LocURI>
                 </Target>
              </Item>
        </delete>
     <Final/>
  </SyncBody>
</SyncML>
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}

已安装的包的全名。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Architecture
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Architecture

已安装包的体系结构。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/InstallDate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/InstallDate

应用的安装日期。 值类型为字符串。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/InstallLocation
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/InstallLocation

在设备上安装应用的位置。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsBundle
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsBundle

如果包是应用捆绑包,则值为 1,对于所有其他情况,则值为 0 (零) 。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsFramework
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsFramework

应用是否为框架包。 值类型为 int。如果应用是框架包,则值为 1,对于所有其他情况,则值为 0 (零) 。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsProvisioned
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsProvisioned

值为 0 或 1,指示是否在设备上预配了应用。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsStub
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/IsStub

此节点用于标识包是否为存根包。 存根包是包的版本,其功能最小,可减小应用的大小。

如果包是存根包,则值为 1,对于所有其他情况,值为 0 (零) 。

值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Name
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Name

应用的名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/PackageStatus
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/PackageStatus

提供有关包状态的信息。 值类型为 int。有效值为:正常 (0) - 包可用。 LicenseIssue (1) - 包的许可证无效。 修改 (2) - 未知源修改了包有效负载。 篡改 (4) - 包有效负载被故意篡改。 禁用 (8) - 包不可用。 仍可对其进行服务。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Publisher
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Publisher

应用的发布者名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/RequiresReinstall
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/RequiresReinstall

指定包状态是否已更改,并且需要重新安装应用。 当需要新的应用资源时(例如,当设备的语言首选项或新的 DPI 发生更改时),可能会发生这种情况。 包损坏也可能发生这种情况。 如果值为 1,则执行应用重新安装。

这是一个必需的节点。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/ResourceID
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/ResourceID

应用的资源 ID。 对于 main 应用,对于捆绑包,此为 null,并且包含资源包的资源信息。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Users
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Users

应用的注册用户和包安装状态。 如果查询位于设备级别,则返回设备的所有已注册用户。 如果查询用户上下文,它将仅返回当前用户。

Requried.

  • 未安装 = 0
  • 分阶段 = 1
  • 已安装 = 2
  • Paused = 6

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Version
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/{PackageFullName}/Version

应用版本。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/{PackageFamilyName}/AppSettingPolicy
范围 版本 适用的操作系统
❌ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/AppSettingPolicy

所有托管应用设置值的内部节点。

仅在用户上下文中支持此节点。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取、替换
User/AppManagement/nonStore/{PackageFamilyName}/AppSettingPolicy/{SettingValue}
范围 版本 适用的操作系统
❌ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/AppSettingPolicy/{SettingValue}

SettingValue 和数据表示要为应用配置的键值对。 节点表示键的名称,数据表示值。 可以在托管的 LocalSettings 中找到此值。 应用程序。 设置容器。

此设置仅适用于支持该功能的应用,并且仅在用户上下文中受支持。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换
动态节点命名 UniqueName:SettingValue 表示键值对中的键。 可以在 Managed.App.Settings 容器的 LocalSettings 中找到值。

以下示例设置“Server”的值

<!— Configure app settings -->
<Add>
   <CmdID>0</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy/Server</LocURI>
      </Target>
      <Meta>
         <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data>server1.contoso.com</Data>
   </Item>
</Add>

以下示例获取特定应用的所有托管应用设置。

<!—Get app settings -->
<Get>
   <CmdID>0</CmdID>
   <Item>
      <Target>
         <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy?list=StructData</LocURI>
      </Target>
   </Item>
</Get>
User/AppManagement/nonStore/{PackageFamilyName}/DoNotUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/DoNotUpdate

指定是否要阻止特定应用通过自动更新进行更新。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。
User/AppManagement/nonStore/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate

指定在 AMD64 设备上,在应用更新中,已安装应用的体系结构是否不得更改。 例如,如果你安装了 Windows 应用的 x86 风格,并且启用了此设置,则在整个更新中,即使 x64 风格可用,也会安装 x86 风格。

AMD64 计算机上的预期行为,该计算机安装了具有 x86 风格的应用 (最严格的胜) 。

适用性设置 CSP 状态 结果
True 未配置 已选取 X86 风格
True 已启用 已选取 X86 风格
True 禁用 已选取 X86 风格
未) 设置假 ( 未配置 选取 X64 风格

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。

User/AppManagement/nonStore/ReleaseManagement

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement

通过 Microsoft Store 管理更新的内部节点。 这些设置允许 IT 管理员为希望用户用于接收更新的应用指定更新通道。 它允许 IT 管理员将特定版本分配给较小的组,以便在将大型部署之前部署到组织的其余部分进行测试。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
User/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}

应用或应用集的标识符。 如果只有一个应用,则为 PackageFamilyName。 如果它适用于一组应用,则为 main 应用的 PackageFamilyName。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
动态节点命名 UniqueName:如果只有一个应用,则名称为 PackageFamilyName。 如果它适用于一组应用,则名称为main应用的 PackageFamilyName。
User/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/ChannelId

指定应用通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换
User/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease

内部节点用于指定在设备上设置多个用户策略时要使用的有效应用版本。 使用设备策略或上次用户策略。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”
User/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId

返回设备上的最后一个用户通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId

返回设备上最后一个用户版本 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId

IT 管理员可以指定发布 ID,以指示他们希望用户或设备处于打开的特定版本。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换

User/AppManagement/RemovePackage

范围 版本 适用的操作系统
❌ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1703 [10.0.15063] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/RemovePackage

用于删除包。

参数:

    • 名称:指定要删除的特定包的 PackageFullName。
    • RemoveForAllUsers:
      • 0 (默认) - 将取消预配包,以便新用户不会收到包。 包将保留为当前用户安装。 目前不支持此选项。
      • 1 - 仅当它是预配的包时,才会删除所有用户的包。
  • 用户 (可选) :指定要删除包的特定用户的 SID;只能删除指定用户的包。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Exec、Get

示例

以下示例删除所有用户的包:

<Exec>
   <CmdID>10</CmdID>
   <Item>
      <Target>
         <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/RemovePackage</LocURI>
      </Target>
      <Meta><Format xmlns="syncml:metinf">xml</Format></Meta>
      <Data>
          <Package Name="{PackageFullName}" RemoveForAllUsers="1" />
      </Data>
   </Item>
</Exec>

User/AppManagement/ResetPackage

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 11版本 21H2 [10.0.22000] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/ResetPackage

用于将 Windows 应用还原到其初始配置。

描述框架属性:

属性名 属性值
格式 xml
访问类型 Exec、Get

User/AppManagement/System

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System

报告作为操作系统的一部分安装的应用。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取

User/AppManagement/System/{PackageFamilyName}

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}

包系列名称 (应用的 PFN) 。 报告清单时,设备上每个 PFN 都有一个。 这些项在其签名源下扎根。

注意

XAP 文件使用产品 ID 代替 PackageFamilyName。 下面是 XAP 产品 ID (包括大括号) 的示例。 {12345678-9012-3456-7890-123456789012}

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory

示例

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
        <!-- Uninstall app -->
        <delete>
           <CmdID>2</CmdID>
              <Item>
                 <Target>
                    <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/%7b12345678-9012-3456-7890-123456789012%7D</LocURI>
                 </Target>
              </Item>
        </delete>
     <Final/>
  </SyncBody>
</SyncML>
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}

已安装的包的全名。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取
动态节点命名 ClientInventory
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Architecture
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Architecture

已安装包的体系结构。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/InstallDate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/InstallDate

应用的安装日期。 值类型为字符串。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/InstallLocation
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/InstallLocation

在设备上安装应用的位置。 值类型为字符串。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsBundle
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsBundle

如果包是应用捆绑包,则值为 1,对于所有其他情况,则值为 0 (零) 。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsFramework
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsFramework

应用是否为框架包。 值类型为 int。如果应用是框架包,则值为 1,对于所有其他情况,则值为 0 (零) 。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsProvisioned
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsProvisioned

值为 0 或 1,指示是否在设备上预配了应用。 值类型为 int。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsStub
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/IsStub

此节点用于标识包是否为存根包。 存根包是包的版本,其功能最小,可减小应用的大小。

如果包是存根包,则值为 1,对于所有其他情况,值为 0 (零) 。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Name
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Name

应用的名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/PackageStatus
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/PackageStatus

提供有关包状态的信息。 值类型为 int。有效值为:正常 (0) - 包可用。 LicenseIssue (1) - 包的许可证无效。 修改 (2) - 未知源修改了包有效负载。 篡改 (4) - 包有效负载被故意篡改。 禁用 (8) - 包不可用。 仍可对其进行服务。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Publisher
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Publisher

应用的发布者名称。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/RequiresReinstall
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/RequiresReinstall

指定包状态是否已更改,并且需要重新安装应用。 当需要新的应用资源时(例如,当设备的语言首选项或新的 DPI 发生更改时),可能会发生这种情况。 包损坏也可能发生这种情况。 如果值为 1,则执行应用重新安装。

这是一个必需的节点。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 int
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/ResourceID
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/ResourceID

应用的资源 ID。 对于 main 应用,对于捆绑包,此为 null,并且包含资源包的资源信息。

注意

不适用于 XAP 文件。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Users
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Users

应用的注册用户和包安装状态。 如果查询位于设备级别,则返回设备的所有已注册用户。 如果查询用户上下文,它将仅返回当前用户。

这是一个必需的节点。

  • 0 = 未安装
  • 1 = 分阶段
  • 2 = 已安装
  • 6 = 已暂停

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Version
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/{PackageFullName}/Version

应用版本。 值类型为字符串。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/{PackageFamilyName}/AppSettingPolicy
范围 版本 适用的操作系统
❌ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppSettingPolicy

所有托管应用设置值的内部节点。

仅在用户上下文中支持此节点。

描述框架属性:

属性名 属性值
格式 node
访问类型 添加、删除、获取、替换
User/AppManagement/System/{PackageFamilyName}/AppSettingPolicy/{SettingValue}
范围 版本 适用的操作系统
❌ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/AppSettingPolicy/{SettingValue}

SettingValue 和数据表示要为应用配置的键值对。 节点表示键的名称,数据表示值。 可以在托管的 LocalSettings 中找到此值。 应用程序。 设置容器。

此设置仅适用于支持该功能的应用,并且仅在用户上下文中受支持。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换
动态节点命名 UniqueName:SettingValue 表示键值对中的键。 可以在 Managed.App.Settings 容器的 LocalSettings 中找到值。

示例

  • 以下示例设置“Server”的值

    <!— Configure app settings -->
    <Add>
        <CmdID>0</CmdID>
        <Item>
           <Target>
              <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy/Server</LocURI>
           </Target>
           <Meta>
              <Format xmlns="syncml:metinf">chr</Format>
           </Meta>
           <Data>server1.contoso.com</Data>
        </Item>
    </Add>
    
  • 以下示例获取特定应用的所有托管应用设置。

    <!—Get app settings -->
    <Get>
        <CmdID>0</CmdID>
        <Item>
           <Target>
              <LocURI>./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/PackageFamilyName/AppSettingPolicy?list=StructData</LocURI>
           </Target>
        </Item>
    </Get>
    
User/AppManagement/System/{PackageFamilyName}/DoNotUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/DoNotUpdate

指定是否要阻止特定应用通过自动更新进行更新。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。
User/AppManagement/System/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 2004 [10.0.19041] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/{PackageFamilyName}/MaintainProcessorArchitectureOnUpdate

指定在 AMD64 设备上,在应用更新中,已安装应用的体系结构是否不得更改。 例如,如果你安装了 Windows 应用的 x86 风格,并且启用了此设置,则在整个更新中,即使 x64 风格可用,也会安装 x86 风格。

AMD64 计算机上的预期行为,该计算机安装了具有 x86 风格的应用 (最严格的胜) 。

适用性设置 CSP 状态 结果
True 未配置 已选取 X86 风格
True 启用 已选取 X86 风格
True 禁用 已选取 X86 风格
未) 设置假 ( 未配置 选取 X64 风格

描述框架属性:

属性名 属性值
格式 int
访问类型 添加、删除、获取、替换

允许的值:

描述
0 假。
1 真。

User/AppManagement/System/ReleaseManagement

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement

通过 Microsoft Store 管理更新的内部节点。 这些设置允许 IT 管理员为希望用户用于接收更新的应用指定更新通道。 它允许 IT 管理员将特定版本分配给较小的组,以便在将大型部署之前部署到组织的其余部分进行测试。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
User/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}

应用或应用集的标识符。 如果只有一个应用,则为 PackageFamilyName。 如果它适用于一组应用,则为 main 应用的 PackageFamilyName。

描述框架属性:

属性名 属性值
格式 node
访问类型 获取、替换
动态节点命名 UniqueName:如果只有一个应用,则名称为 PackageFamilyName。 如果它适用于一组应用,则名称为main应用的 PackageFamilyName。
User/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/ChannelId

指定应用通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换
User/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease

内部节点用于指定在设备上设置多个用户策略时要使用的有效应用版本。 使用设备策略或上次用户策略。

描述框架属性:

属性名 属性值
格式 node
访问类型 “获取”
User/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ChannelId

返回设备上的最后一个用户通道 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/EffectiveRelease/ReleaseManagementId

返回设备上最后一个用户版本 ID。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 “获取”
User/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId
范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/System/ReleaseManagement/{ReleaseManagementKey}/ReleaseManagementId

IT 管理员可以指定发布 ID,以指示他们希望用户或设备处于打开的特定版本。

描述框架属性:

属性名 属性值
格式 chr (字符串)
访问类型 添加、删除、获取、替换

User/AppManagement/UpdateScan

范围 版本 适用的操作系统
✅ 设备
✅ 用户
✅ 专业版
✅ 企业版
✅ 教育版
✅ Windows SE
✅ IoT 企业版/IoT 企业版 LTSC
✅Windows 10版本 1511 [10.0.10586] 及更高版本
./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/UpdateScan

用于启动Windows 更新扫描。

这是一个必需的节点。

描述框架属性:

属性名 属性值
格式 null
访问类型 Exec

EnterpriseModernAppManagement XSD

下面是应用程序参数的 XSD。

<?xml version="1.0" encoding="utf-16"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="Data">
        <xs:complexType>
            <xs:sequence>
                <xs:element maxOccurs="1" name="Application">
                    <xs:complexType mixed="true">
                        <xs:sequence minOccurs="0">
                            <xs:element name="Dependencies">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element maxOccurs="unbounded" name="Dependency">
                                            <xs:complexType>
                                                <xs:attribute name="PackageUri" type="xs:string" use="required" />
                                            </xs:complexType>
                                        </xs:element>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:sequence>
                        <xs:attribute name="DeploymentOptions" type="xs:unsignedByte" use="optional" />
                        <xs:attribute name="PackageUri" type="xs:string" use="required" />
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

示例

有关如何使用此 CSP 来报告应用清单、安装和删除用户应用、将应用预配到设备以及管理应用许可证的示例,请参阅 企业应用管理

在设备中查询特定应用子类别,例如 nonStore 应用。

<Get>
  <CmdID>1</CmdID>
  <Item>
    <Target>
      <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore</LocURI>
    </Target>
  </Item>
</Get>

结果包含应用列表,例如 <Data>App1/App2/App</Data>。

针对特定应用的属性进行后续查询。

<Get>
   <CmdID>1</CmdID>
   <Item>
     <Target>
       <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/App1?list=StructData</LocURI>
     </Target>
   </Item>
</Get>
<Get>
  <CmdID>2</CmdID>
  <Item>
    <Target>
      <LocURI>./Device/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/nonStore/App2?list=StructData</LocURI>
    </Target>
  </Item>
</Get>

配置服务提供程序参考