ActiveSync 云解决方案提供商ActiveSync CSP

ActiveSync 配置服务提供程序用于设置和更改 Exchange ActiveSync。The ActiveSync configuration service provider is used to set up and change settings for Exchange ActiveSync. 在 ActiveSync 配置服务提供商对 Exchange 帐户进行无线更新后,设备必须关闭电源,然后重新打开以查看同步状态。After an Exchange account has been updated over-the-air by the ActiveSync configuration service provider, the device must be powered off and then powered back on to see sync status.

不支持Windows Live配置服务提供程序配置 ActiveSync 帐户。Configuring Windows Live ActiveSync accounts through this configuration service provider is not supported.

备注

目标用户必须登录,云解决方案提供商才能成功。The target user must be logged in for the CSP to succeed. 配置帐户的正确方法就是使用 ./User/Vendor/MSFT/ActiveSync 路径。The correct way to configure an account is to use the ./User/Vendor/MSFT/ActiveSync path.

在桌面上,仅支持每个用户配置 (./User/Vendor/MSFT/ActiveSync) 。On the desktop, only per user configuration (./User/Vendor/MSFT/ActiveSync) is supported. 但是,如果用户已登录,./Vendor/MSFT/ActiveSync 路径将有效。However, the ./Vendor/MSFT/ActiveSync path will work if the user is logged in. 当没有用户登录时,CSP 将失败。The CSP fails when no user is logged in.

./Vendor/MSFT/ActiveSync 路径已弃用,但短期将继续有效。The ./Vendor/MSFT/ActiveSync path is deprecated, but will continue to work in the short term.

下面显示了开放移动联盟设备管理 (OMA DM) 、OMA 客户端预配和企业 DM 使用的树格式的 ActiveSync 配置服务提供程序管理对象。The following shows the ActiveSync configuration service provider management objects in tree format as used by Open Mobile Alliance Device Management (OMA DM), OMA Client Provisioning, and Enterprise DM.

./Vendor/MSFT
ActiveSync
----Accounts
--------Account GUID
------------EmailAddress
------------Domain
------------AccountIcon
------------AccountType
------------AccountName
------------Password
------------ServerName
------------UserName
------------Options
----------------CalendarAgeFilter
----------------Logging
----------------MailBodyType
----------------MailHTMLTruncation
----------------MailPlainTextTruncation
----------------Schedule
----------------UseSSL
----------------MailAgeFilter
----------------ContentTypes
--------------------Content Type GUID
------------------------Enabled
------------------------Name
------------Policies
----------------MailBodyType
----------------MaxMailAgeFilter

./User/Vendor/MSFT/ActiveSync./User/Vendor/MSFT/ActiveSync
ActiveSync 配置服务提供程序的根节点。The root node for the ActiveSync configuration service provider.

备注

目标用户必须登录,云解决方案提供商才能成功。The target user must be logged in for the CSP to succeed. 配置帐户的正确方法就是使用 ./User/Vendor/MSFT/ActiveSync 路径。The correct way to configure an account is to use the ./User/Vendor/MSFT/ActiveSync path.

在桌面上,仅支持每个用户配置 (./User/Vendor/MSFT/ActiveSync) 。On the desktop, only per user configuration (./User/Vendor/MSFT/ActiveSync) is supported. 但是,如果用户已登录,./Vendor/MSFT/ActiveSync 将正常工作。However, the ./Vendor/MSFT/ActiveSync will work if the user is logged in. 当没有用户登录时,CSP 将失败。The CSP fails when no user is logged in.

./Vendor/MSFT/ActiveSync 路径已弃用,但短期将继续有效。The ./Vendor/MSFT/ActiveSync path is deprecated, but will continue to work in the short term.

支持的操作是 Get。The supported operation is Get.

帐户Accounts
所有 ActiveSync 帐户的根节点。The root node for all ActiveSync accounts.

支持的操作是 Get。The supported operation is Get.

帐户 GUIDAccount GUID
定义特定的 ActiveSync 帐户。Defines a specific ActiveSync account. 必须为设备上每个 ActiveSync (GUID) 全局唯一标识符。A globally unique identifier (GUID) must be generated for each ActiveSync account on the device.

支持的操作包括 Get、Add 和 Delete。Supported operations are Get, Add, and Delete.

通过 OMA DM 管理时,请确保始终使用唯一的 GUID。When managing over OMA DM, make sure to always use a unique GUID. 使用与现有帐户具有相同的 GUID 的帐户进行预配将删除现有帐户,并且不会创建新帐户。Provisioning with an account that has the same GUID as an existing one deletes the existing account and does not create the new account.

GUID 周围需要大括号 { } 。Braces { } are required around the GUID. 在 OMA 客户端预配中,你可以键入大括号。In OMA Client Provisioning, you can type the braces. 例如:For example:

<characteristic type="{C556E16F-56C4-4EDB-9C64-D9469EE1FBE0}"/>

对于 OMA DM,必须将 %7B 和 %7D 的 ASCII 值分别用于左括号和右大括号。For OMA DM, you must use the ASCII values of %7B and %7D for the opening and closing braces, respectively. 例如,如果 GUID 为"C556E16F-56C4-4EDB-9C64-D9469EE1FBE0",请键入:For example, if the GUID is "C556E16F-56C4-4EDB-9C64-D9469EE1FBE0", type:

<Target>
   <LocURI>
      ./Vendor/MSFT/ActiveSync/Accounts/%7BC556E16F-56C4-4EDB-9C64-D9469EE1FBE0%7D
   </LocURI>
</Target>

*帐户 GUID*/EmailAddress*Account GUID*/EmailAddress
必需。Required. 指定与帐户关联的电子邮件地址的Exchange ActiveSync字符串。A character string that specifies the email address associated with the Exchange ActiveSync account.

支持的操作包括 Get、Replace 和 Add (创建帐户后无法添加) 。Supported operations are Get, Replace, and Add (cannot Add after the account is created).

此电子邮件地址在设置过程中由用户输入,并且必须采用完全限定的电子邮件地址格式,例如"someone@example.com"。This email address is entered by the user during setup and must be in the fully qualified email address format, for example, "someone@example.com".

*帐户 GUID*/域*Account GUID*/Domain
对于 Exchange,可选。Optional for Exchange. 指定 Exchange 服务器的域名。Specifies the domain name of the Exchange server.

支持的操作包括 Get、Replace、Add 和 Delete。Supported operations are Get, Replace, Add, and Delete.

*帐户 GUID*/AccountIcon*Account GUID*/AccountIcon
必需。Required. 一个字符串,指定与帐户关联的图标的位置。A character string that specifies the location of the icon associated with the account.

支持的操作包括 Get、Replace 和 Add (创建帐户后无法添加) 。Supported operations are Get, Replace, and Add (cannot Add after the account is created).

帐户图标可以用作"开始"列表中的磁贴或应用程序**** 列表中的图标(在"设置 ">"&帐户"下)。The account icon can be used as a tile in the Start list or an icon in the applications list under Settings > email & accounts. 已在设备上提供一些图标。Some icons are already provided on the device. POP/IMAP 或通用 ActiveSync 帐户的建议图标位于 res://AccountSettingsSharedRes{ScreenResolution}!%s.genericmail.png。The suggested icon for POP/IMAP or generic ActiveSync accounts is at res://AccountSettingsSharedRes{ScreenResolution}!%s.genericmail.png. Exchange 帐户的建议图标位于 res://AccountSettingsSharedRes{ScreenResolution}!%s.office.outlook.png。The suggested icon for Exchange Accounts is at res://AccountSettingsSharedRes{ScreenResolution}!%s.office.outlook.png. 如果需要,可以添加自定义图标。Custom icons can be added if desired.

*帐户 GUID*/AccountType*Account GUID*/AccountType
必需。Required. 一个指定帐户类型的字符串。A character string that specifies the account type.

支持的操作是 Get 和 Add (创建帐户后无法添加) 。Supported operations are Get and Add (cannot Add after the account is created).

此值在安装过程中输入,输入后无法修改。This value is entered during setup and cannot be modified once entered. Exchange 帐户由字符串值"Exchange"指示。An Exchange account is indicated by the string value "Exchange".

*帐户 GUID*/AccountName*Account GUID*/AccountName
必需。Required. 一个字符串,用于指定引用设备上帐户的名称。A character string that specifies the name that refers to the account on the device.

支持的操作包括 Get、Replace 和 Add (创建帐户后无法添加) 。Supported operations are Get, Replace, and Add (cannot Add after the account is created).

*帐户 GUID*/密码*Account GUID*/Password
必需。Required. 指定帐户密码的字符串。A character string that specifies the password for the account.

支持的操作包括 Get、Replace、Add 和 Delete。Supported operations are Get, Replace, Add, and Delete.

对于 Get 命令,仅返回星号。For the Get command, only asterisks are returned.

*帐户 GUID*/ServerName*Account GUID*/ServerName
必需。Required. 一个指定帐户所使用的服务器名称的字符串。A character string that specifies the server name used by the account.

支持的操作包括 Get、Replace 和 Add (创建帐户后无法添加) 。Supported operations are Get, Replace, and Add (cannot Add after the account is created).

*帐户 GUID*/UserName*Account GUID*/UserName
必需。Required. 一个指定帐户的用户名的字符串。A character string that specifies the user name for the account.

支持的操作包括 Get 和 Add (在帐户创建后无法添加) 。Supported operations are Get, and Add (cannot Add after the account is created).

成功执行同步后,无法更改用户名。The user name cannot be changed after a sync has been successfully performed. 用户名可以是完全限定格式"someone@example.com"或"用户名",具体取决于创建的帐户类型。The user name can be in the fully qualified format "someone@example.com", or just "username", depending on the type of account created. 对于大多数 Exchange 帐户,用户名格式只是"用户名",而对于 Microsoft、Google、Yahoo 和大多数 POP/IMAP 帐户,用户名格式为"someone@example.com"。For most Exchange accounts, the user name format is just "username", whereas for Microsoft, Google, Yahoo, and most POP/IMAP accounts, the user name format is "someone@example.com".

选项Options
其他参数的节点。Node for other parameters.

Options/CalendarAgeFilterOptions/CalendarAgeFilter
指定用于将日历项目同步到设备的时间窗口。Specifies the time window used for syncing calendar items to the device. 值类型为 chr。Value type is chr.

选项/日志记录Options/Logging
必需。Required. 一个字符串,指定是否启用诊断日志记录以及处于什么级别。A character string that specifies whether diagnostic logging is enabled and at what level. 默认值为 0, (禁用) 。The default is 0 (disabled).

支持的操作包括 Get、Replace 和 Add (创建帐户后无法添加) 。Supported operations are Get, Replace, and Add (cannot Add after the account is created).

有效值为下列值之一:Valid values are one of the following:

  • 0 (默认值) - 日志记录已关闭。0 (default) - Logging is off.

  • 1 - 启用基本日志记录。1 - Basic logging is enabled.

  • 2 - 启用高级日志记录。2 - Advanced logging is enabled.

默认情况下,日志记录设置为关闭。Logging is set to off by default. 当出现客户支持正在调查的同步问题时,系统可能会要求用户将此选项设置为基本或高级。The user might be asked to set this to Basic or Advanced when having a sync issue that customer support is investigating. 将日志记录级别设置为"高级"比"基本"对性能的影响大。Setting the logging level to Advanced has more of a performance impact than Basic.

Options/MailBodyTypeOptions/MailBodyType
指示电子邮件格式。Indicates the email format. 有效值:Valid values:

  • 0 - 无0 - none
  • 1 - 文本1 - text
  • 2 - HTML2 - HTML
  • 3 - RTF3 - RTF
  • 4 - MIME4 - MIME

Options/MailHTMLTruncationOptions/MailHTMLTruncation
指定 HTML 格式的电子邮件在同步到移动设备时被截断的大小。Specifies the size beyond which HTML-formatted email messages are truncated when they are synchronized to the mobile device. 该值以 KB 为单位指定。The value is specified in KB. 值 -1 禁用截断。A value of -1 disables truncation.

Options/MailPlainTextTruncationOptions/MailPlainTextTruncation
此设置指定文本格式的电子邮件在同步到移动电话时被截断的大小。This setting specifies the size beyond which text-formatted e-mail messages are truncated when they are synchronized to the mobile phone. 该值以 KB 为单位指定。The value is specified in KB. 值 -1 禁用截断。A value of -1 disables truncation.

Options/UseSSLOptions/UseSSL
可选。Optional. 一个指定是否使用 SSL 的字符串。A character string that specifies whether SSL is used.

支持的操作包括 Get、Replace 和 Add (创建帐户后无法添加) 。Supported operations are Get, Replace, and Add (cannot Add after the account is created).

有效值包括:Valid values are:

  • 0 - 不使用 SSL。0 - SSL is not used.

  • 1 (默认) - 使用 SSL。1 (default) - SSL is used.

选项/计划Options/Schedule
必需。Required. 一个字符串,指定执行下一个同步之前的时间(分钟)。A character string that specifies the time until the next sync is performed, in minutes. 默认值为 -1。The default value is -1.

支持的操作包括 Get 和 Replace。Supported operations are Get and Replace.

有效值为下列值之一:Valid values are one of the following:

  • -1 (默认) - 接收项目时将发生同步-1 (default) - A sync will occur as items are received

  • 0 - 必须手动执行所有同步0 - All syncs must be performed manually

  • 15 - 每 15 分钟同步一次15 - Sync every 15 minutes

  • 30 - 每 30 分钟同步一次30 - Sync every 30 minutes

  • 60 - 每 60 分钟同步一次60 - Sync every 60 minutes

Options/MailAgeFilterOptions/MailAgeFilter
必需。Required. 一个字符串,指定用于将电子邮件项目同步到设备的时间窗口。A character string that specifies the time window used for syncing email items to the device. 默认值为 3。The default value is 3.

支持的操作包括 Get 和 Replace。Supported operations are Get and Replace.

有效值为下列值之一:Valid values are one of the following:

  • 0 – 不使用年龄筛选器,并且所有电子邮件项目都同步到设备。0 – No age filter is used, and all email items are synced to the device.

  • 2 – 仅将最多三天的电子邮件同步到设备。2 – Only email up to three days old is synced to the device.

  • 3 (默认) – 最多一周的电子邮件将同步到设备。3 (default) – Email up to a week old is synced to the device.

  • 4 – 将最多两周之前的电子邮件同步到设备。4 – Email up to two weeks old is synced to the device.

  • 5 – 将最多一个月的电子邮件同步到设备。5 – Email up to a month old is synced to the device.

Options/ContentTypes/ 内容类型 GUIDOptions/ContentTypes/Content Type GUID
定义要单独启用/禁用同步的内容类型。Defines the type of content to be individually enabled/disabled for sync.

允许 的 GUID 值是下列值之一:The GUID values allowed are one of the following:

  • 电子邮件:"{c6d47067-6e92-480e-b0fc-4ba82182fac7}"Email: "{c6d47067-6e92-480e-b0fc-4ba82182fac7}"

  • 联系人:"{0dd8685c-e272-4fcb-9ecf-2ead7ea2497b}"Contacts: "{0dd8685c-e272-4fcb-9ecf-2ead7ea2497b}"

  • 日历:"{4a5d9fe0-f139-4a63-a5a4-4f31ceea02ad}"Calendar: "{4a5d9fe0-f139-4a63-a5a4-4f31ceea02ad}"

  • 任务:"{783ae4f6-4c12-4423-8270-66361260d4f1}"Tasks: "{783ae4f6-4c12-4423-8270-66361260d4f1}"

Options/ContentTypes/Content Type GUID/EnabledOptions/ContentTypes/Content Type GUID/Enabled
必需。Required. 指定对所选内容类型启用还是禁用同步的字符串。A character string that specifies whether sync is enabled or disabled for the selected content type. 默认值为"1", (启用) 。The default is "1" (enabled).

支持的操作包括 Get、Replace 和 Add (创建帐户后无法添加) 。Supported operations are Get, Replace, and Add (cannot Add after the account is created).

有效值为下列值之一:Valid values are one of the following:

  • 0 - 禁用电子邮件、联系人、日历或任务的同步。0 - Sync for email, contacts, calendar, or tasks is disabled.
  • 1 (默认) - 同步已启用。1 (default) - Sync is enabled.

Options/ContentTypes/Content Type GUID/NameOptions/ContentTypes/Content Type GUID/Name
必需。Required. 一个指定内容类型名称的字符串。A character string that specifies the name of the content type.

备注

在 Windows 10 中,此节点当前无法工作。In Windows 10, this node is currently not working.

支持的操作包括 Get、Replace 和 Add (创建帐户后无法添加) 。Supported operations are Get, Replace, and Add (cannot Add after the account is created).

当你在 SyncML 的原子块内使用 Add 或 Replace 时,CSP 将返回错误,并且设置失败。When you use Add or Replace inside an atomic block in the SyncML, the CSP returns an error and provisioning fails. 当你在原子块之外使用 Add 或 Replace 时,将忽略该错误,并且会如期预配帐户。When you use Add or Replace outside of the atomic block, the error is ignored and the account is provisioned as expected.

策略Policies
邮件正文类型和电子邮件年龄筛选器的节点。Node for mail body type and email age filter.

Policies/MailBodyTypePolicies/MailBodyType
必需。Required. 指定电子邮件正文类型:HTML 或纯文本。Specifies the email body type: HTML or plain.

值类型为字符串。Value type is string. 支持的操作包括添加、获取、替换和删除。Supported operations are Add, Get, Replace, and Delete.

Policies/MaxMailAgeFilterPolicies/MaxMailAgeFilter
必需。Required. 指定用于将邮件项目同步到设备的时间窗口。Specifies the time window used for syncing mail items to the device.

值类型为字符串。Value type is string. 支持的操作包括添加、获取、替换和删除。Supported operations are Add, Get, Replace, and Delete.

配置服务提供程序参考Configuration service provider reference