此产品的文档集力求使用非歧视性语言。在本文档集中，非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言，文档中可能无法确保完全使用非歧视性语言。 深入了解思科如何使用包容性语言。
思科可能会在某些地方提供本内容的当地语言翻译版本。请注意，翻译版本仅供参考，如有任何不一致之处，以本内容的英文版本为准。
使用 IM and Presence Service 批量管理工具，您可以对许多 IM and Presence Service 用户执行批量事务，包括：
重命名用户联系人 ID 以在 Microsoft 迁移过程中使用。
将属于特定节点或 Presence 冗余组的用户的联系人列表、非 Presence 联系人列表和位置详细信息导出到 CSV 数据文件。
 注 |
非 Presence 联系人都没有 IM 地址，并且只能通过此程序导出。 |
您可以导入已导出到不同群集中的另一个节点或 Presence 冗余组的用户联系人列表、非 Presence 联系人列表和用户位置迁移详细信息。为新用户预填联系人列表或添加到现有联系人列表。
这些功能简化了群集之间的用户迁移。
在导入用户联系人列表之前：
在 Cisco Unified Communications Manager 上部署用户。
确保在 Cisco Unified Communications Manager 上为 IM and Presence Service 许可用户。
注 |
默认联系人列表导入速度取决于虚拟机部署硬件类型。可以选择 来更改联系人列表导入速度。但是，如果您增大默认导入速度，将会在 IM and Presence Service 上消耗更多的 CPU 和内存。 |
| 命令或操作 | 目的 | |
|---|---|---|
| 步骤 1 |
上传 CSV 文件并重命名用户列表的联系人 ID。 |
|
| 步骤 2 |
此程序用于将用户的联系人列表导出到 CSV 文件。然后，您可以使用批量管理将用户联系人列表移到另一个节点或群集。 |
|
| 步骤 3 |
此程序用于将用户位置详细信息导出到 CSV 文件。然后，您可以使用批量管理将用户位置详细信息列表移到另一个节点或群集。 |
|
| 步骤 4 |
完成以下任务以将用户联系人列表导入 IM and Presence Service： |
 小心 |
批量重命名联系人 ID 操作在将用户从 Microsoft 服务器（如 Lync）迁移到 IM and Presence Service 的时候使用。有关如何在用户迁移过程中使用此工具的详细说明，请参阅 Cisco.com 上的《分区式域内联合指南》。任何其他情形均不支持使用此工具。 |
上传 CSV 文件并重命名用户列表的联系人 ID。
| 步骤 1 |
上传包含了您希望在所有联系人列表中重命名的联系人 ID 列表的 CSV 文件。
|
| 步骤 2 |
在发布方节点的 Cisco Unified CM IM and Presence 管理中，选择。 |
| 步骤 3 |
在文件名字段中，选择您要上传的文件。 |
| 步骤 4 |
选择如下操作之一：
|
| 步骤 5 |
单击提交。 如果选择立即运行作业，将在您单击“提交”后运行作业。 |
您在运行此作业之前上传的文件必须是以下格式的 CSV 文件：
<联系人 ID>, <新联系人 ID>
其中 <联系人 ID> 是现有的联系人 ID，<新联系人 ID> 是新格式的联系人 ID。
<联系人 ID> 是在 Presence 拓扑用户分配窗口上显示的用户 IM 地址。
下面是 CSV 文件示例，有一个条目：
Contact ID, New Contact ID
john.smith@example.com, jsmith@example.com此程序用于将用户的联系人列表导出到 CSV 文件。然后，您可以使用批量管理将用户联系人列表移到另一个节点或群集。
联系人列表 — 此列表包含 IM and Presence 联系人。没有 IM 地址的联系人将不会导出（您必须导出非 Presence 联系人列表）。
非 Presence 联系人列表 — 此列表包含没有 IM 地址的联系人。
| 步骤 1 |
在 Cisco Unified CM IM and Presence 管理中，执行以下任一操作：
|
| 步骤 2 |
仅联系人列表。选择要导出其联系人列表的用户：
|
| 步骤 3 |
在文件名字段中，输入 CSV 文件的名称。 |
| 步骤 4 |
在作业信息下，配置要运行此作业的时间：
|
| 步骤 5 |
单击提交。 |
| 步骤 6 |
在创建导出文件后，下载导出的文件：
|
此程序用于将用户位置详细信息导出到 CSV 文件。然后，您可以使用批量管理将用户位置详细信息移到另一个节点或群集。
| 步骤 1 |
在 Cisco Unified CM IM and Presence 管理中，选择。 |
| 步骤 2 |
在用户位置详细信息导出下的文件名字段中，输入 CSV 文件的名称。 |
| 步骤 3 |
在作业信息下，配置要运行此作业的时间：
|
| 步骤 4 |
单击提交。 |
| 步骤 5 |
在创建导出文件后，下载导出的文件：
|
以下是 CSV 文件示例条目：
userA,example.com,userB,example.com,buddyB,General,0
BAT 允许您查找和选择要导出其联系人列表的用户。用户联系人列表将导出为格式如下的 CSV 文件：
<用户 ID>,<用户域名>,<联系人 ID>,<联系人域名>,<昵称>,<组名>,<状态>
下表介绍了导出文件中的参数。
|
参数 |
说明 |
||
|---|---|---|---|
|
用户 ID |
IM and Presence Service 用户的用户 ID。
|
||
|
用户域名 |
IM and Presence Service 用户的 Presence 域名。
示例 1：bjones@example.com—bjones 是用户 ID，example.com 是用户域。 示例 2：bjones@usa@example.com—bjones@usa 是用户 ID，example.com 是用户域。 |
||
|
联系人 ID |
联系人列表条目的用户 ID。 |
||
|
联系人域名 |
联系人列表条目的 Presence 域名。 |
||
|
昵称 |
联系人列表条目的昵称。 如果用户未为联系人指定昵称，则“昵称”参数将为空。 |
||
|
组名 |
要添加联系人列表条目的组的名称。 如果用户的联系人未分类到组中，默认组名将在“组名”字段中指定。 |
||
|
状态 |
名录的状态，名录数据库以十进制格式存储它。 |
非 Presence 用户联系人列表将导出为格式如下的 CSV 文件：
<用户 JID>,<联系人 JID>,<组名称>,<内容类型>,<版本>,<信息>
下表介绍了导出文件中的参数：
|
参数 |
说明 |
|---|---|
|
用户 JID |
用户 JID。这是用户的 IM 地址。 |
|
联系人 JID |
联系人列表条目的用户 JID（如果可用），否则为 UUID。 |
|
组名 |
要添加联系人列表条目的组的名称。 |
|
内容类型 |
信息字段中使用的 textmime 类型和子类型。 |
|
版本 |
信息字段中使用的内容类型。 |
|
信息 |
vCard 格式的联系人列表条目的联系信息。 |
以下是 CSV 文件示例条目：
user2@cisco.com,ce463d44-02c3-4975-a37f-d4553e3f17e1,group01,text/directory,3,BEGIN:VCARD
ADR;TYPE=WORK:ADR\;WORK:\;\;123 Dublin rd\,\;Oranmore\;Galway\;\;Ireland
EMAIL;TYPE=X-CUSTOM1;X LABEL=Custom:testuser01@test.com N:test;user;;; NICKNAME:pizzaguy01
ORG:ABC TEL;TYPE=WORK,VOICE:5323534535 TITLE:QA VERSION:3.0 END:VCARD用户位置详细信息将导出为格式如下的 CSV 文件：
<用户 JID>,<访问类型>,<创建时间>,<项 ID>,<资源 ID>,<消息文本>
小心 |
由于文件本身的大小以及存在损坏用户位置信息的风险，我们建议您不要手动修改导出的 CSV 文件。 |
下表介绍了导出文件中的参数：
|
参数 |
说明 |
||
|---|---|---|---|
|
用户 JID |
用户 JID。这是用户的 IM 地址。 |
||
|
访问类型 |
访问类型定义用户的访问类型。 访问类型的值如下：
|
||
|
创建时间 |
“创建时间”显示项目创建或更新的日期和时间。 |
||
|
项目 ID |
“项 ID”标识用户的特定记录。 |
||
|
资源 ID |
“资源 ID”是 Jabber 实例 ID。 |
||
|
消息文本 |
“消息文本”是用户的位置信息。 |
以下是 CSV 文件示例条目：
userA@example.com,W,2021-01-22 10:11:18.000001,7d0ec34c-458f-4fd2-9d15-58accac4af00,jabber_7151,<geoloc xmlns='http://jabber.org/protocol/geoloc'><description>newlocation104</description><street>104</street><mobile>0</mobile><enable>1</enable></geoloc>
检查 IM and Presence Service 上的“最大联系人列表大小”和“最大查看器数”设置。“最大联系人列表大小”的系统默认值为 200，“最大查看器数”的系统默认值为 200。
思科建议导入用户联系人列表时将“最大联系人列表大小”和“最大查看器数”设置设为“无限制”。即使在使用 BAT 导入联系人列表时超过最大联系人列表大小而未丢失数据，此步骤也可确保完全导入每个迁移用户的联系人列表。迁移所有用户后，您可以将“最大联系人列表大小”和“最大查看器数”设置重置为首选值。
您只需在群集上检查最大联系人列表大小（这些群集包含希望要对其导入联系人的用户）。更改 Presence 设置时，更改会应用到群集中的所有节点；因此您只需在群集中的 IM and Presence 数据库发布方节点上更改这些设置。
以下程序介绍如何使用 BAT 上传联系人列表和非 Presence 联系人列表的 CSV 输入文件。
| 步骤 1 |
在 Cisco Unified CM IM and Presence 管理中，选择。 |
| 步骤 2 |
单击新增。 |
| 步骤 3 |
单击浏览找到并选择 CSV 文件。 |
| 步骤 4 |
对于目标设置：
|
| 步骤 5 |
对于事务类型：选择作为事务类型。
|
| 步骤 6 |
单击保存上传该文件。 |
输入文件必须是采用以下格式的 CSV 文件：
<用户 ID>,<用户域名>,<联系人 ID>,<联系人域名>,<昵称>,<组名>,<状态>
以下是 CSV 文件示例条目：
userA,example.com,userB,example.com,buddyB,General,0
下表说明输入文件中的参数。
|
参数 |
说明 |
||
|---|---|---|---|
|
用户 ID |
这是必要参数。 IM and Presence Service 用户的用户 ID。最多可包含 132 个字符。
|
||
|
用户域名 |
这是必要参数。 IM and Presence Service 用户的 Presence 域名。最多可包含 128 个字符。
|
||
|
联系人 ID |
这是必要参数。 联系人列表条目的用户 ID。最多可包含 132 个字符。 |
||
|
联系人域名 |
这是必要参数。 联系人列表条目的 Presence 域名。域名格式需遵守以下限制：
|
||
|
昵称 |
联系人列表条目的昵称。最多可包含 255 个字符。 |
||
|
组名 |
“组名称”是必填参数。 要添加联系人列表条目的组的名称。最多可包含 255 个字符。 |
||
|
状态 |
名录的状态，名录数据库以十进制格式存储它。 |
输入文件必须是采用以下格式的 CSV 文件：
<用户 JID>,<联系人 JID>,<组名称>,<内容类型>,<版本>,<信息>
以下是 CSV 文件示例条目：
user2@cisco.com,ce463d44-02c3-4975-a37f-d4553e3f17e1,group01,text/directory,3,BEGIN:VCARD
ADR;TYPE=WORK:ADR\;WORK:\;\;123 Dublin rd\,\;Oranmore\;Galway\;\;Ireland
EMAIL;TYPE=X-CUSTOM1;X LABEL=Custom:testuser01@test.com N:test;user;;; NICKNAME:pizzaguy01
ORG:ABC TEL;TYPE=WORK,VOICE:5323534535 TITLE:QA VERSION:3.0 END:VCARD小心 |
由于文件本身的大小以及存在损坏 vCard 信息的风险，我们建议您不要手动修改 CSV 文件。 下表说明非 Presence 联系人输入文件中的参数。 |
|
参数 |
说明 |
|---|---|
|
用户 JID |
用户 JID。这是用户的 IM 地址。 |
|
联系人 JID |
联系人列表条目的用户 JID（如果可用），否则为 UUID。 |
|
组名 |
要添加联系人列表条目的组的名称。 |
|
内容类型 |
信息字段中使用的 textmime 类型和子类型。 |
|
版本 |
信息字段中使用的内容类型。 |
|
信息 |
vCard 格式的联系人列表条目的联系信息。 |
输入文件必须是采用以下格式的 CSV 文件：
<用户 JID>,<访问类型>,<项 ID>,<创建时间>,<资源 ID>,<消息文本>
以下是 CSV 文件示例条目：
userA@example.com,W,7d0ec34c-458f-4fd2-9d15-58accac4af00,2021-01-22 10:11:18.000001,jabber_7151,<geoloc xmlns='http://jabber.org/protocol/geoloc'><description>newlocation104</description><street>104</street><mobile>0</mobile><enable>1</enable></geoloc>小心 |
由于文件本身的大小以及存在损坏用户位置信息的风险，我们建议您不要手动修改 CSV 文件。 |
下表描述了输入文件中用于用户位置迁移的参数：
|
参数 |
说明 |
||
|---|---|---|---|
|
用户 JID |
这是必要参数。 “用户 JID”是用户的 IM 地址。最多可包含 255 个字符。 |
||
|
访问类型 |
这是必选参数。访问类型定义用户的访问类型。最多可包含 128 个字符。 访问类型的值如下：
|
||
|
项目 ID |
这是必要参数。 “项 ID”标识用户的特定记录。“项 ID”的值应为“忽略”或字母数字值。联系人列表条目的用户 ID。最多可包含 50 个字符。 |
||
|
创建时间 |
这是必要参数。 “创建时间”显示项目创建或更新的日期和时间。最多可包含 26 个字符。 |
||
|
资源 ID |
这是必要参数。 “资源 ID”是 Jabber 实例 ID。最多可包含 1023 个字符。 |
||
|
消息文本 |
这是必要参数。 “消息文本”是用户的位置信息。最多可包含 30000 个字符。 |
为联系人列表和非 Presence 联系人列表创建新的批量管理作业。
| 步骤 1 |
在 Cisco Unified CM IM and Presence 管理中：
|
| 步骤 2 |
从“文件名”下拉列表中，选择要导入的文件。 |
| 步骤 3 |
在“作业说明”字段中，输入此批量管理作业的说明。 |
| 步骤 4 |
选择下列操作之一：
|
| 步骤 5 |
单击提交。如果选择立即运行作业，将在您单击“提交”后运行作业。 |
当批量管理作业完成后，IM and Presence Service BAT 工具会将联系人列表导入作业的结果写入日志文件。该日志文件包含以下信息：
已成功导入的联系人数量。
尝试导入联系人时遇到的内部服务器错误的数量。
未导入（忽略）的联系人数量。日志文件会在日志文件末尾针对每个被忽略的联系人列出未导入的原因。下面是未导入联系人的原因：
格式无效 - 行格式无效，如必需字段缺失或为空
联系人域无效 - 联系人域的格式无效。有关联系人域的有效格式，请参阅与批量导入用户联系人列表相关的主题。
不能将自己添加为联系人 - 如果联系人为用户本人，则无法导入该联系人。
用户联系人列表大小超过上限 - 用户已达到最大联系人列表大小，无法导入该用户的更多联系人
用户未分配给本地节点 - 用户尚未分配到本地节点
CSV 文件中由于导致 BAT 作业过早结束的错误而未处理的联系人数量。此错误极少发生。
完成以下过程即可访问此日志文件。
| 步骤 1 |
在 Cisco Unified CM IM and Presence 管理中，选择。 |
| 步骤 2 |
单击查找并选择联系人列表导入作业的作业 ID。 |
| 步骤 3 |
单击记录文件名链接即可打开日志。 |
反馈