w7 APPLICATION 云解决方案提供商

  • 项目

下表显示了 Windows 的适用性：

版次 Windows 10 Windows 11
Home 键 是 是
专业版 是 是
Windows SE 否 是
商用版 是 是
企业 是 是
教育 是 是

APPID 为 w7 的应用程序配置服务提供程序用于使用 OMA DM 帐户启动设备。 尽管此配置服务提供程序用于设置 OMA DM 帐户，但它通过 OMA 客户端预配进行管理。

注意

此配置服务提供程序需要从网络配置应用程序访问ID_CAP_CSP_FOUNDATION和ID_CAP_DEVICE_MANAGEMENT_ADMIN功能。

下面显示了 OMA 客户端预配使用的树格式配置服务提供程序。

APPLICATION
---APPADDR
------ADDR
------ADDRTYPE
------PORT
---------PORTNBR
---APPAUTH
------AAUTHDATA
------AAUTHLEVEL
------AAUTHNAME
------AAUTHSECRET
------AAUTHTYPE
---AppID
---BACKCOMPATRETRYDISABLED
---CONNRETRYFREQ
---DEFAULTENCODING
---INIT
---INITIALBACKOFTIME
---MAXBACKOFTIME
---NAME
---PROTOVER
---PROVIDER-ID
---ROLE
---TO-NAPID
---USEHWDEVID
---SSLCLIENTCERTSEARCHCRITERIA

注意

所有参数名称和特征类型都区分大小写，必须使用所有大写。 预配 XML 时必须同时提供 APPSRV 和 CLIENT 凭据。

APPADDR 此特征在 w7 APPLICATION 特征中用于指定 DM 服务器地址。

APPADDR/ADDR 选。 ADDR 参数在 APPADDR 特征中使用，用于获取或设置 OMA DM 服务器的地址。 此参数采用字符串值。

APPADDR/ADDRTYPE 选。 ADDRTYPE 参数在 APPADDR 特征中使用来获取或设置 ADDR 参数的格式。 此参数采用字符串值。

在 OMA DM XML 中，如果此参数有多个实例，则使用第一个有效参数值。

APPADDR/PORT 此特征在 APPADDR 特征中用于指定端口信息。

APPADDR/PORT/PORTNBR 必填。 PORTNBR 参数用于在 PORT 特征中获取或设置要连接到的端口数。 此参数采用字符串格式的数值。

APPAUTH 此特征在 w7 APPLICATION 特征中用于指定身份验证信息。

APPAUTH/AAUTHDATA 选。 在 APPAUTH 特征中使用 AAUTHDATA 参数来获取或设置身份验证中使用的更多数据。 此参数用于传达摘要式身份验证类型的 nonce。 此参数采用字符串值。 此参数的值是 base64 编码的一系列字节形式。 如果 AAUTHTYPE 为 DIGEST，则此值用作 MD5 哈希计算中的 nonce 值，在服务器端和设备端计算哈希时，应使用二进制数据的八进制形式。

APPAUTH/AAUTHLEVEL 必填。 AAUTHLEVEL 参数在 APPAUTH 特征中使用，用于指示凭据是用于服务器身份验证还是用于客户端身份验证。 此参数采用字符串值。 可以设置此值。

有效值：

  • APPSRV - 指定客户端在 DM 协议级别向 OMA DM 服务器进行身份验证。

  • CLIENT - 指定服务器在 DM 协议级别向 OMA DM 客户端进行身份验证。

APPAUTH/AAUTHNAME 选。 AAUTHNAME 参数在 APPAUTH 特征中使用来区分 OMA DM 客户端名称。 此参数采用字符串值。 可以设置此值。

APPAUTH/AAUTHSECRET 必填。 AAUTHSECRET 参数用于在 APPAUTH 特征中获取或设置用于对用户进行身份验证的身份验证机密。 此参数采用字符串值。

APPAUTH/AAUTHTYPE 选。 APPAUTH 特征的 AAUTHTYPE 参数用于获取或设置身份验证方法。 此参数采用字符串值。

有效值：

  • BASIC - 指定 SyncML DM“syncml：auth-basic”身份验证类型。
  • DIGEST - 指定 SyncML DM“syncml：auth-md5”身份验证类型。
  • 当 AAUTHLEVEL 为 CLIENT 时，AAUTHTYPE 必须为 DIGEST。 当 AAUTHLEVEL 为 APPSRV 时，AAUTHTYPE 可以是 BASIC 或 DIGEST。

APPID 必填。 APPID 参数在 APPLICATION 特征中用于区分可用应用程序服务和协议的类型。 此参数采用字符串值。 可以获取或设置此值。 配置 OMA 客户端预配引导 APPID 的唯一有效值是 w7。

BACKCOMPATRETRYDISABLED 选。 APPLICATION 特征中使用 BACKCOMPATRETRYDISABLED 参数来指定是否重试使用较旧的协议版本 (重新发送包，例如，SyncHdr 中的 1.1) (不包括首次) 。

注意

此参数不包含值。 此参数的存在意味着禁用向后兼容性重试。 如果缺少 参数，则表示已启用向后兼容性重试。

CONNRETRYFREQ 选。 CONNRETRYFREQ 参数在 APPLICATION 特征中用于指定 DM 客户端在出现连接管理器级或 WinInet 级错误时执行的重试次数。 此参数采用字符串格式的数值。 默认值为“3”。 可以设置此参数。

DEFAULTENCODING 选。 在 APPLICATION 特征中使用 DEFAULTENCODING 参数来指定 DM 客户端在与服务器通信时是否应对 DM 包使用 WBXML 或 XML。 可以获取或设置此参数。

有效值为：

  • application/vnd.syncml.dm+xml (默认)
  • application/vnd.syncml.dm+wbxml

Init 选。 INIT 参数在 APPLICATION 特征中使用，以指示管理服务器希望客户端在设置批准后立即启动管理会话。 如果当前 w7 APPLICATION 文档将放入 ROM 中，则 INIT 参数必须不存在。

注意

此节点仅适用于尝试使用此节点的移动运营商和 MDM 服务器将失败。 企业 MDM 注册方案中不支持此节点。 此参数强制设备尝试与 OMA DM 服务器连接。 如果在 coldinit 阶段设置了 XML，则连接尝试将失败。 这种失败的一个常见原因是，在 coldinit 完成后，无线电尚未准备就绪。

  INITIALBACKOFFTIME 选。 在 APPLICATION 特征中使用 INITIALBACKOFFTIME 参数来指定 DM 客户端首次重试时的初始等待时间（以毫秒为单位）。 等待时间呈指数级增长。 此参数采用字符串格式的数值。 默认值为“16000”。 可以获取或设置此参数。

MAXBACKOFFTIME 选。 MAXBACKOFFTIME 参数用于在 APPLICATION 特征中指定在包发送失败后要休眠的最大毫秒数。 此参数采用字符串格式的数值。 默认值为“86400000”。 可以设置此参数。

名字 选。 NAME 参数用于在 APPLICATION 特征中指定用户可读的应用程序标识。 此参数用于定义 APPLICATION 参数的部分注册表路径。 可以设置此参数。

NAME 参数可以是字符串或 null， (没有值) 。 如果未指定任何值，注册表位置将默认为 <未命名>。

PROTOVER 选。 在 APPLICATION 特征中使用 PROTOVER 参数来指定服务器支持的 OMA DM 协议版本。 不假定默认值。 此节点设置的协议版本将与 DM 客户端在包 1 中的 SyncHdr 中向服务器报告的协议版本匹配。 如果在添加 DM 服务器帐户时未指定此节点，则使用客户端支持的最新 DM 协议版本。 在 Windows Phone 中，此版本为 1.2。 此参数是 Microsoft 自定义参数。 可以设置此参数。

可能值：

  • 1.1
  • 1.2

PROVIDER-ID 选。 在 APPLICATION 特征中使用 PROVIDER-ID 参数来区分 OMA DM 服务器。 它指定当前管理会话中使用的管理服务器的服务器标识符。 此参数采用字符串值。 可以设置此参数。

作用 选。 ROLE 参数在 APPLICATION 特征中用于指定与 DM 服务器通信时 DM 会话应用于运行的安全应用程序室。 唯一支持的角色是 8 (移动运营商) 和 32 (企业) 。 如果不存在此参数，则假定移动运营商角色。 企业角色只能由企业注册客户端设置。 企业客户端无法设置移动运营商角色。 此参数是 Microsoft 自定义参数。 此参数采用字符串格式的数值。 可以获取或设置此参数。

TO-NAPID 选。 在 APPLICATION 特征中使用 TO-NAPID 参数来指定客户端用于连接到 OMA DM 服务器的网络接入点。 如果指定了多个 TO-NAPID 参数，则只会存储第一个 TO-NAPID 值。 此参数采用字符串值。 可以设置此参数。

USEHWDEVID 选。 APPLICATION 特征中使用 USEHWDEVID 参数来指定设备硬件标识的使用。 它没有值。

  • 如果参数不存在，则默认行为是使用所使用的特定于应用程序的 GUID，而不是硬件设备 ID。
  • 如果存在 参数，则会在发送到服务器的 DM 包的 ./DevInfo/DevID 节点和源 LocURI 中提供硬件设备 ID。 为 GSM 设备返回国际移动用户标识 (IMEI) 。

SSLCLIENTCERTSEARCHCRITERIA 选。 在 APPLICATION 特征中使用 SSLCLIENTCERTSEARCHCRITERIA 参数来指定客户端证书搜索条件。 此参数支持按主题属性和证书存储进行搜索。 如果提供了任何其他条件，则会忽略它。

字符串是名称/值对的串联，该对的每个成员由“&”字符分隔。 名称和值由“=”字符分隔。 如果有多个值，则每个值由 Unicode 字符“U+F000”分隔。 如果名称或值包含的字符不在 RFC2396) 中指定的 UNRESERVED 集中 (，则根据 RFC 对这些字符进行 URI 转义。

支持的名称为 Subject 和 Store;不支持通配符证书搜索。

存储指定 DM 客户端将搜索以查找 SSL 客户端证书的存储证书。 有效的存储值为 My%5CUser。 应用商店名称不区分大小写。   Subject 指定要搜索的证书。 例如，若要指定具有特定 Subject 属性的证书 (“CN=Tester，O=Microsoft”) ，请使用以下命令：

注意

%EF%80%80 是 UTF8 编码的字符 U+F000。

<parm name="SSLCLIENTCERTSEARCHCRITERIA"
   value="Subject=CN%3DTester,O%3DMicrosoft&amp;Stores=My%5CUser" />

配置服务提供程序参考